OID_RECEIVE_FILTER_ENUM_FILTERS
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:
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.
Ü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_RECEIVE_FILTER_INFO_ARRAY
OID_RECEIVE_FILTER_ALLOCATE_QUEUE