OID_RECEIVE_FILTER_CURRENT_CAPABILITIES
Überlastende Treiber geben OID-Abfrageanforderungen von OID_RECEIVE_FILTER_CURRENT_CAPABILITIES aus, um die derzeit aktivierten Empfangsfilterfunktionen eines Netzwerkadapters abzurufen.
Nach erfolgreicher Rückgabe 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-E/A-Virtualisierung (SR-IOV) Weitere Informationen zur Verwendung von Empfangsfiltern in dieser Schnittstelle finden Sie unter Festlegen eines Empfangsfilters für einen virtuellen Port.
Virtual Machine Queue (VMQ). Weitere Informationen zur Verwendung von Empfangsfiltern in dieser Schnittstelle finden Sie unter Festlegen und Löschen von VMQ-Filtern.
Ab NDIS 6.20 registrieren Miniporttreiber die derzeit aktivierten Empfangsfilterhardwarefunktionen 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 Hardwarefunktionen für die Empfangsfilterung.
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.
Überlastende Protokoll- und Filtertreiber müssen keine OID-Abfrageanforderungen von OID_RECEIVE_FILTER_CURRENT_CAPABILITIES ausgeben. NDIS stellt die derzeit aktivierten Empfangsfilterfunktionen für diese Treiber auf folgende Weise bereit:
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 überlasten.
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 überlasten.
Zurückgeben status Codes
NDIS verarbeitet die OID-Abfrageanforderung von OID_RECEIVE_FILTER_CURRENT_CAPABILITIES für Miniporttreiber und gibt einen der folgenden status-Codes zurück:
NDIS_STATUS_SUCCESS
Die Anforderung wurde erfolgreich abgeschlossen. Der InformationBuffer verweist auf eine NDIS_RECEIVE_FILTER_CAPABILITIES-Struktur.
NDIS_STATUS_PENDING
Die Anforderung steht aus. NDIS übergibt den endgültigen status Code und die Ergebnisse an den OID-Anforderungsvervollständigungshandler des Aufrufers, nachdem die Anforderung abgeschlossen wurde.
NDIS_STATUS_INVALID_LENGTH
Der Informationspuffer war zu kurz. NDIS legt die DATEN fest. QUERY_INFORMATION. BytesNeed-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
Die Anforderung ist aus anderen Gründen fehlgeschlagen.
Requirements (Anforderungen)
Version |
Unterstützt in NDIS 6.20 und höher. |
Header |
Ntddndis.h (include Ndis.h) |