OID_RECEIVE_FILTER_GLOBAL_PARAMETERS

Überlastende Treiber geben OID-Abfrageanforderungen von OID_RECEIVE_FILTER_GLOBAL_PARAMETERS aus, um die globalen Empfangsfilterparameter 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_GLOBAL_PARAMETERS-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 verwenden Protokolltreiber OID_RECEIVE_FILTER_GLOBAL_PARAMETERS, um die aktuellen globalen Konfigurationsparameter für die Empfangsfilterung auf einem Netzwerkadapter abzufragen. Beispielsweise können Protokolltreiber diese OID verwenden, um zu bestimmen, ob Die Typen von Empfangsfiltern oder Empfangswarteschlangen aktiviert oder deaktiviert sind.

Zurückgeben status Codes

NDIS verarbeitet die OID-Abfrageanforderung von OID_RECEIVE_FILTER_GLOBAL_PARAMETERS für Miniporttreiber und gibt einen der folgenden status-Codes zurück:

NDIS_STATUS_SUCCESS
Die Anforderung wurde erfolgreich abgeschlossen.

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 ist.

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_INVALID_PARAMETER
Fehler bei der Anforderung, weil versucht wurde, eine Funktion zu aktivieren, die vom zugrunde liegenden Netzwerkadapter nicht unterstützt wird.

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)

Weitere Informationen

NDIS_OID_REQUEST

NDIS_RECEIVE_FILTER_GLOBAL_PARAMETERS