Auf Englisch lesen

Freigeben über


OID_RECEIVE_FILTER_ENUM_QUEUES

Überlastende Treiber und Benutzermodusanwendungen geben OID-Abfrageanforderungen (Object Identifier) von OID_RECEIVE_FILTER_ENUM_QUEUES aus, um eine Liste aller Empfangswarteschlangen abzurufen, die auf einem Netzwerkadapter zugeordnet sind.

Nach einer erfolgreichen Rückgabe von der OID-Abfrageanforderung enthält der InformationBuffer-Member der NDIS_OID_REQUEST-Struktur einen Zeiger auf eine NDIS_RECEIVE_QUEUE_INFO_ARRAY-Struktur , auf die eine NDIS_RECEIVE_QUEUE_INFO-Struktur für jeden Filter folgt.

Bemerkungen

NDIS hat die Informationen aus einem internen Cache der Daten abgerufen, die es von den OID_RECEIVE_FILTER_ALLOCATE_QUEUE und OID_RECEIVE_FILTER_QUEUE_PARAMETERS OID-Anforderungen erhalten hat.

Überlastete Treiber und Benutzermodusanwendungen geben OID-Abfrageanforderungen von OID_RECEIVE_FILTER_ENUM_QUEUES aus, um die Empfangswarteschlangen auf einem Netzwerkadapter aufzulisten.

Wenn ein Protokolltreiber die Anforderung ausgibt, wird der Anforderungstyp innerhalb der NDIS_OID_REQUEST-Struktur auf NdisRequestQueryInformation festgelegt, und diese OID gibt ein Array aller Empfangswarteschlangen zurück, die der Protokolltreiber dem Netzwerkadapter zugeordnet hat. Wenn eine Benutzermodusanwendung die Anforderung ausgestellt hat, wird der Anforderungstyp innerhalb der NDIS_OID_REQUEST-Struktur auf NdisRequestQueryStatistics festgelegt, und diese OID gibt ein Array von Informationen für alle Empfangswarteschlangen auf dem Netzwerkadapter zurück.

Zurückgeben von Statuscodes

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

Statuscode BESCHREIBUNG

NDIS_STATUS_SUCCESS

Die Anforderung wurde erfolgreich abgeschlossen. Der InformationBuffer verweist auf eine NDIS_RECEIVE_QUEUE_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. METHOD_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_QUEUE_INFO

NDIS_RECEIVE_QUEUE_INFO_ARRAY

OID_RECEIVE_FILTER_ALLOCATE_QUEUE

OID_RECEIVE_FILTER_QUEUE_PARAMETERS