Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Überlastungstreiber stellen OID-Abfrageanforderungen von OID_RECEIVE_FILTER_CURRENT_CAPABILITIES aus, um die aktuell aktivierten Empfangsfilterfunktionen eines Netzwerkadapters abzurufen.
Nach einer erfolgreichen Rückgabe aus der OID-Abfrageanforderung enthält das InformationBuffer Element der NDIS_OID_REQUEST-Struktur einen Zeiger auf eine NDIS_RECEIVE_FILTER_CAPABILITIES Struktur.
Bemerkungen
NDIS-Empfangsfilter werden in den folgenden NDIS-Schnittstellen verwendet:
NDIS Packet Coalescing. Weitere Informationen zur Verwendung von Empfangsfiltern in dieser Schnittstelle finden Sie unter Managing Packet Coalescing Receive Filters.
Single Root I/O Virtualization (SR-IOV). Weitere Informationen zur Verwendung von Empfangsfiltern in dieser Schnittstelle finden Sie unter Festlegen eines Empfangsfilters für einen virtuellen Port.
VMQ(Virtual Machine Queue). Weitere Informationen zur Verwendung von Empfangsfiltern in dieser Schnittstelle finden Sie unter Einstellung und Löschen von VMQ-Filtern.
Ab NDIS 6.20 registrieren Miniporttreiber die derzeit aktivierten Filterhardwarefunktionen des Netzwerkadapters, wenn die MiniportInitializeEx- funktion aufgerufen wird. Miniport-Treiber registrieren diese Funktionen, indem Sie die folgenden Schritte ausführen:
Der Treiber initialisiert eine NDIS_RECEIVE_FILTER_CAPABILITIES Struktur mit den derzeit aktivierten Filterhardwarefunktionen.
Der Treiber initialisiert eine NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES Struktur und legt den CurrentReceiveFilterCapabilities Member auf einen Zeiger auf die NDIS_RECEIVE_FILTER_CAPABILITIES Struktur fest.
Der Miniporttreiber ruft die NdisMSetMiniportAttributes--Funktion auf und legt den MiniportAttributes Parameter auf einen Zeiger auf eine NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES Struktur fest.
Überlastungsprotokoll- und Filtertreiber müssen keine OID-Abfrageanforderungen von OID_RECEIVE_FILTER_CURRENT_CAPABILITIES ausstellen. NDIS bietet die derzeit aktivierten Empfangsfilterfunktionen für diese Treiber auf folgende Weise:
NDIS stellt die derzeit aktivierten Empfangsfilterfunktionen eines zugrunde liegenden Netzwerkadapters bereit, um Protokolltreiber im ReceiveFilterCapabilities Member der NDIS_BIND_PARAMETERS Struktur während des Bindungsvorgangs zu überschreiben.
NDIS stellt die derzeit aktivierten Empfangsfilterfunktionen eines zugrunde liegenden Netzwerkadapters bereit, um Filtertreiber im ReceiveFilterCapabilities Member der NDIS_FILTER_ATTACH_PARAMETERS Struktur während des Anfügenvorgangs zu überschreiben.
Rückgabestatuscodes
NDIS behandelt die OID-Abfrageanforderung von OID_RECEIVE_FILTER_CURRENT_CAPABILITIES für Miniporttreiber und gibt einen der folgenden Statuscodes zurück:
NDIS_STATUS_SUCCESS
Die Anforderung wurde erfolgreich abgeschlossen. Die InformationBuffer- verweist auf eine NDIS_RECEIVE_FILTER_CAPABILITIES Struktur.
NDIS_STATUS_PENDING
Die Anforderung steht aus. NDIS übergibt den endgültigen Statuscode und ergebnisse an den OID-Anforderungsabschlusshandler des Aufrufers, nachdem die Anforderung abgeschlossen wurde.
NDIS_STATUS_INVALID_LENGTH
Der Informationspuffer war zu kurz. NDIS legt die DATA fest. QUERY_INFORMATION. BytesNeededed Member in der NDIS_OID_REQUEST Struktur auf die erforderliche Mindestpuffergröße.
NDIS_STATUS_NOT_SUPPORTED
Der Netzwerkadapter unterstützt keine Empfangsfilterung.
NDIS_STATUS_FAILURE
Fehler bei der Anforderung aus anderen Gründen.
Anforderungen
Version |
Unterstützt in NDIS 6.20 und höher. |
Kopfball |
Ntddndis.h (include Ndis.h) |