OID_RECEIVE_FILTER_ENUM_QUEUES

Artikel
06/15/2023

Ü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.