OID_RECEIVE_FILTER_ENUM_QUEUES
Overlying drivers and user-mode applications issue object identifier (OID) query requests of OID_RECEIVE_FILTER_ENUM_QUEUES (Overlying drivers and user-mode applications issue object identifier) requests of OID_RECEIVE_FILTER_ENUM_QUEUES to uzyskiwanie listy wszystkich kolejek odbierania przydzielonych na karcie sieciowej.
Po pomyślnym powrocie z żądania zapytania OID InformationBuffer struktury NDIS_OID_REQUEST zawiera wskaźnik do struktury NDIS_RECEIVE_QUEUE_INFO_ARRAY, po której następuje struktura NDIS_RECEIVE_QUEUE_INFO dla każdego filtru.
Uwagi
Usługa NDIS uzyskała informacje z wewnętrznej pamięci podręcznej danych otrzymanych z OID_RECEIVE_FILTER_ALLOCATE_QUEUE i OID_RECEIVE_FILTER_QUEUE_PARAMETERS żądań OID.
Nadmierne sterowniki i aplikacje w trybie użytkownika wystawiają żądania zapytań OID OID_RECEIVE_FILTER_ENUM_QUEUES w celu wyliczenia kolejek odbierania na karcie sieciowej.
Jeśli sterownik protokołu wystawia żądanie, typ żądania wewnątrz struktury NDIS_OID_REQUEST jest ustawiony na NdisRequestQueryInformation i ten identyfikator OID zwraca tablicę wszystkich kolejek odbierania, które sterownik protokołu przydzielony na karcie sieciowej. Jeśli aplikacja w trybie użytkownika wystawiła żądanie, typ żądania wewnątrz struktury NDIS_OID_REQUEST jest ustawiony na NdisRequestQueryStatistics, a ten identyfikator OID zwraca tablicę informacji dla wszystkich kolejek odbierania na karcie sieciowej.
Kody stanu powrotu
Usługa NDIS obsługuje żądanie zapytania OID OID_RECEIVE_FILTER_ENUM_QUEUES dla sterowników miniportu i zwraca jeden z następujących kodów stanu.
| Kod stanu | Opis |
|---|---|
NDIS_STATUS_SUCCESS |
Żądanie zostało ukończone pomyślnie. InformationBuffer wskazuje strukturę NDIS_RECEIVE_QUEUE_INFO_ARRAY. |
NDIS_STATUS_PENDING |
Żądanie oczekuje na ukończenie. Usługa NDIS przekaże końcowy kod stanu i wyniki do procedury obsługi ukończenia żądania OID obiektu wywołującego po zakończeniu żądania. |
NDIS_STATUS_INVALID_LENGTH |
Bufor informacyjny był zbyt krótki. NDIS ustaw DATA.METHOD_INFORMATION.składowej bytesNeeded w strukturze NDIS_OID_REQUEST do minimalnego wymaganego rozmiaru buforu. |
NDIS_STATUS_FAILURE |
Żądanie nie powiodło się z innych powodów. |
Wymagania
Wersja |
Obsługiwane w usłudze NDIS 6.20 lub nowszym. |
Nagłówek |
Ntddndis.h (m.in. Ndis.h) |