Share via

OID_RECEIVE_FILTER_ENUM_FILTERS

  • Artikel

Ein übermäßiger Treiber gibt eine OID-Methodenanforderung von OID_RECEIVE_FILTER_ENUM_FILTERS aus, um eine Liste aller Filter abzurufen, die auf einem Netzwerkadapter konfiguriert sind.

Das InformationBuffer-Element der NDIS_OID_REQUEST-Struktur enthält einen Zeiger auf eine NDIS_RECEIVE_FILTER_INFO_ARRAY-Struktur .

Nach einer erfolgreichen Rückgabe von der OID-Methodenanforderung enthält der InformationBuffer-Member der NDIS_OID_REQUEST-Struktur einen Zeiger auf einen Puffer. Dieser Puffer ist so formatiert, dass er Folgendes enthält:

  • Eine NDIS_RECEIVE_FILTER_INFO_ARRAY-Struktur , die eine Liste der Empfangsfilter angibt, die derzeit für einen Miniporttreiber konfiguriert sind.

  • Ein Array von NDIS_RECEIVE_FILTER_INFO Strukturen. Jede Struktur gibt die Parameter eines Empfangsfilters an, der derzeit für einen Miniporttreiber konfiguriert ist.

Bemerkungen

NDIS-Empfangsfilter werden in den folgenden NDIS-Schnittstellen verwendet:

Überlastete Treiber oder Anwendungen geben OID-Methodenanforderungen von OID_RECEIVE_FILTER_ENUM_FILTERS aus, um die Empfangsfilter aufzulisten, die auf einem Netzwerkadapter festgelegt wurden. Dies schließt Empfangsfilter ein, die für einen virtuellen SR-IOV-Port (VPort) oder eine VMQ-Empfangswarteschlange festgelegt wurden.

Zusätzliche Richtlinien für die NDIS-Paketkopplungsschnittstelle

Ab Windows Server 2012 unterstützt die NDIS-Paketverknappung nur die Standard-Empfangswarteschlange eines Netzwerkadapters.

Um die Paket-Sammel-Empfangsfilter aufzulisten, muss der übergeordnete Treiber den QueueId-Member der NDIS_RECEIVE_FILTER_INFO_ARRAY-Struktur auf NDIS_DEFAULT_RECEIVE_QUEUE_ID festlegen.

Zusätzliche Richtlinien für die SR-IOV-Schnittstelle

Ab Windows Server 2012 unterstützt die SR-IOV-Schnittstelle nur die Standard-Empfangswarteschlange eines virtuellen Ports (VPort).

Um die VPort-Empfangsfilter aufzulisten, muss der übersteigende Treiber den QueueId-Member der NDIS_RECEIVE_FILTER_INFO_ARRAY-Struktur auf NDIS_DEFAULT_RECEIVE_QUEUE_ID festlegen.

Zusätzliche Richtlinien für die VMQ-Schnittstelle

Ein übermäßiger Treiber kann OID-Methodenanforderungen von OID_RECEIVE_FILTER_ENUM_FILTERS ausgeben, um die Empfangsfilter aufzulisten, die für eine VMQ-Empfangswarteschlange festgelegt wurden. Wenn der übergeordnete Treiber die NDIS_RECEIVE_FILTER_INFO_ARRAY-Struktur initialisiert, wird das QueueId-Element auf einen der folgenden Werte festgelegt:

  • Der Warteschlangenbezeichnerwert für eine nicht standardmäßige Empfangswarteschlange. Der überlastende Treiber hat den Eingabewert des Warteschlangenbezeichners aus einer früheren OID-Methodenanforderung von OID_RECEIVE_FILTER_ALLOCATE_QUEUE oder einer OID-Abfrageanforderung von OID_RECEIVE_FILTER_ENUM_QUEUES abgerufen.

  • Der Warteschlangenbezeichnerwert von NDIS_DEFAULT_RECEIVE_QUEUE_ID, der die Standard-Empfangswarteschlange angibt.

Zurückgeben von status Codes

NDIS verarbeitet die OID-Methodenanforderung von OID_RECEIVE_FILTER_ENUM_FILTERS 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_INFO_ARRAY-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 wurde.

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_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_INFO

NDIS_RECEIVE_FILTER_INFO_ARRAY

OID_RECEIVE_FILTER_ALLOCATE_QUEUE

OID_RECEIVE_FILTER_ENUM_QUEUES

OID_RECEIVE_FILTER_SET_FILTER