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