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) |