Freigeben über


OID_RECEIVE_FILTER_ENUM_QUEUES

Das Überführen von Treibern und Anwendungen im Benutzermodus stellt Abfrageanforderungen von OID_RECEIVE_FILTER_ENUM_QUEUES aus, um eine Liste aller Empfangenwarteschlangen abzurufen, die auf einem Netzwerkadapter zugeordnet sind.

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

Bemerkungen

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

Beim Überlisten von Treibern und Anwendungen im Benutzermodus werden OID-Abfrageanforderungen von OID_RECEIVE_FILTER_ENUM_QUEUES aus, um die Empfangswarteschlangen auf einem Netzwerkadapter auflisten zu können.

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

Rückgabestatuscodes

NDIS behandelt die OID-Abfrageanforderung von OID_RECEIVE_FILTER_ENUM_QUEUES für Miniporttreiber und gibt einen der folgenden Statuscodes zurück.

Statuscode Beschreibung

NDIS_STATUS_SUCCESS

Die Anforderung wurde erfolgreich abgeschlossen. Die InformationBuffer- verweist auf eine NDIS_RECEIVE_QUEUE_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 den DATA-fest.METHOD_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_OID_REQUEST

NDIS_RECEIVE_QUEUE_INFO

NDIS_RECEIVE_QUEUE_INFO_ARRAY

OID_RECEIVE_FILTER_ALLOCATE_QUEUE

OID_RECEIVE_FILTER_QUEUE_PARAMETERS