Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 aus der OID-Methodenanforderung enthält das 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 auf einem 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.
Single Root I/O Virtualization (SR-IOV). Weitere Informationen zur Verwendung von Empfangsfiltern in dieser Schnittstelle finden Sie unter Festlegen eines Empfangsfilters für einen virtuellen Port.
VMQ(Virtual Machine Queue). Weitere Informationen zur Verwendung von Empfangsfiltern in dieser Schnittstelle finden Sie unter Einstellung und Löschen von VMQ-Filtern.
Beim Überlisten von Treibern oder Anwendungen werden OID-Methodenanforderungen von OID_RECEIVE_FILTER_ENUM_FILTERS gestellt, um die Empfangenfilter auflisten zu können, die auf einem Netzwerkadapter festgelegt wurden. Dies schließt den Empfang von Filtern ein, die für einen SR-IOV virtuellen Port (Virtual Port, VPort) oder eine VMQ-Empfangswarteschlange festgelegt wurden.
Zusätzliche Richtlinien für die NDIS Packet Coalescing Interface
Ab Windows Server 2012 unterstützt NDIS-Pakete nur die Standard-Empfangswarteschlange eines Netzwerkadapters.
Zum Aufzählen der Empfangenfilter für Pakete muss der Überlauftreiber die 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 auflisten zu können, muss der Überlauftreiber die QueueId Mitglied 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 Empfangenfilter auflisten, die in einer VMQ-Empfangswarteschlange festgelegt wurden. Wenn der überlastende Treiber die NDIS_RECEIVE_FILTER_INFO_ARRAY-Struktur initialisiert, legt er den QueueId- Member auf einen der folgenden Werte fest:
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_QUEUESabgerufen.
Der Warteschlangenbezeichnerwert von NDIS_DEFAULT_RECEIVE_QUEUE_ID, der die Standard-Empfangswarteschlange angibt.
Rückgabestatuscodes
NDIS behandelt die OID-Methodenanforderung von OID_RECEIVE_FILTER_ENUM_FILTERS für Miniporttreiber und gibt einen der folgenden Statuscodes zurück:
NDIS_STATUS_SUCCESS
Die Anforderung wurde erfolgreich abgeschlossen. Die InformationBuffer- verweist auf eine NDIS_RECEIVE_FILTER_INFO_ARRAY Struktur.
NDIS_STATUS_PENDING
Die Anforderung steht aus. NDIS übergibt den endgültigen Statuscode und ergebnisse an den OID-Anforderungsabschlusshandler des Aufrufers, nachdem die Anforderung abgeschlossen wurde.
NDIS_STATUS_INVALID_LENGTH
Der Informationspuffer war zu kurz. NDIS legt die DATA fest. QUERY_INFORMATION. BytesNeededed Member in der NDIS_OID_REQUEST Struktur auf die erforderliche Mindestpuffergröße.
NDIS_STATUS_FAILURE
Fehler bei der Anforderung aus anderen Gründen.
Anforderungen
Version |
Unterstützt in NDIS 6.20 und höher. |
Kopfball |
Ntddndis.h (include Ndis.h) |
Siehe auch
NDIS_RECEIVE_FILTER_INFO_ARRAY
OID_RECEIVE_FILTER_ALLOCATE_QUEUE