OID_RECEIVE_FILTER_HARDWARE_CAPABILITIES
Überlastende Treiber geben OID-Abfrageanforderungen von OID_RECEIVE_FILTER_HARDWARE_CAPABILITIES aus, um die Empfangsfilterhardwarefunktionen eines Netzwerkadapters zu erhalten.
Nach einer erfolgreichen Rückgabe von der OID-Abfrageanforderung enthält das InformationBuffer-Element der NDIS_OID_REQUEST-Struktur einen Zeiger auf eineNDIS_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.For more information about how to use receive filters in this interface, see Managing Packet Coalescing Receive Filters.
Single Root E/O Virtualization (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.
Die NDIS_RECEIVE_FILTER_CAPABILITIES-Struktur enthält Informationen zu den Empfangsfilterhardwarefunktionen eines Netzwerkadapters. Diese Funktionen können Hardwarefunktionen umfassen, die derzeit von den INF-Dateieinstellungen oder über die Seite Erweiterte Eigenschaften deaktiviert sind.
Hinweis Alle Empfangsfilterhardwarefunktionen eines Netzwerkadapters werden über eine OID-Abfrageanforderung von OID_RECEIVE_FILTER_HARDWARE_CAPABILITIES zurückgegeben, unabhängig davon, ob eine Funktion aktiviert oder deaktiviert ist.
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 Empfangsfilterhardwarefunktionen.
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.
Zurückgeben von status Codes
NDIS verarbeitet die OID-Abfrageanforderung von OID_RECEIVE_FILTER_HARDWARE_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 noch aus. NDIS übergibt den endgültigen status Code und die Ergebnisse an den OID-Anforderungsabschlusshandler des Aufrufers, nachdem die Anforderung abgeschlossen ist.
NDIS_STATUS_INVALID_LENGTH
Der Informationspuffer war zu kurz. NDIS legt die DATEN fest. QUERY_INFORMATION. BytesNeeded-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) |