OID_RECEIVE_FILTER_ENUM_FILTERS
Nadmierny sterownik wystawia żądanie metody OID OID_RECEIVE_FILTER_ENUM_FILTERS w celu uzyskania listy wszystkich filtrów skonfigurowanych na karcie sieciowej.
Element InformationBuffer struktury NDIS_OID_REQUEST zawiera wskaźnik do struktury NDIS_RECEIVE_FILTER_INFO_ARRAY.
Po pomyślnym powrocie z żądania metody OID InformationBuffer składowej struktury NDIS_OID_REQUEST zawiera wskaźnik do buforu. Ten bufor jest sformatowany tak, aby zawierał następujące elementy:
Struktura NDIS_RECEIVE_FILTER_INFO_ARRAY określająca listę filtrów odbierania, które są obecnie skonfigurowane w sterowniku miniportu.
Tablica struktur NDIS_RECEIVE_FILTER_INFO. Każda struktura określa parametry filtru odbierania, który jest obecnie skonfigurowany na sterowniku miniportu.
Uwagi
Filtry odbierania NDIS są używane w następujących interfejsach NDIS:
pakiet NDIS łączący. Aby uzyskać więcej informacji na temat używania filtrów odbierania w tym interfejsie, zobacz Zarządzanie łączeniem pakietów filtrów odbierania.
wirtualizacji we/wy pojedynczego katalogu głównego (SR-IOV). Aby uzyskać więcej informacji na temat używania filtrów odbierania w tym interfejsie, zobacz Ustawianie filtru odbierania na porcie wirtualnym.
kolejki maszyn wirtualnych (VMQ). Aby uzyskać więcej informacji o sposobie używania filtrów odbierania w tym interfejsie, zobacz Setting and Clearing VMQ Filters.
Nadmierne sterowniki lub aplikacje wydają żądania metody OID OID_RECEIVE_FILTER_ENUM_FILTERS w celu wyliczenia filtrów odbierania ustawionych na karcie sieciowej. Obejmuje to filtry odbierania, które zostały ustawione na SR-IOV port wirtualny (VPort) lub kolejkę odbierania vmQ.
Dodatkowe wytyczne dotyczące interfejsu łączenia pakietów NDIS
Począwszy od systemu Windows Server 2012, łączenie pakietów NDIS obsługuje tylko domyślną kolejkę odbierania karty sieciowej.
Aby wyliczyć filtry odbierania pakietów, nadmierny sterownik musi ustawić element QueueId elementu członkowskiego struktury NDIS_RECEIVE_FILTER_INFO_ARRAY, aby NDIS_DEFAULT_RECEIVE_QUEUE_ID.
Dodatkowe wytyczne dotyczące interfejsu SR-IOV
Począwszy od systemu Windows Server 2012, interfejs SR-IOV obsługuje tylko domyślną kolejkę odbierania portu wirtualnego (VPort).
Aby wyliczyć filtry odbierania VPort, sterownik nadmiernego działania musi ustawić QueueId elementu członkowskiego struktury NDIS_RECEIVE_FILTER_INFO_ARRAY, aby NDIS_DEFAULT_RECEIVE_QUEUE_ID.
Dodatkowe wytyczne dotyczące interfejsu VMQ
Nadmierny sterownik może wysyłać żądania metody OID OID_RECEIVE_FILTER_ENUM_FILTERS w celu wyliczenia filtrów odbierania ustawionych w kolejce odbierania vmQ. Gdy sterownik nadmiernie inicjuje strukturę NDIS_RECEIVE_FILTER_INFO_ARRAY, ustawia element członkowski QueueId na jedną z następujących wartości:
Wartość identyfikatora kolejki dla kolejki odbieranej bez definicji. Nadmierny sterownik uzyskał wartość wejściową identyfikatora kolejki z wcześniejszego żądania metody OID OID_RECEIVE_FILTER_ALLOCATE_QUEUE lub żądania zapytania OID OID_RECEIVE_FILTER_ENUM_QUEUES.
Wartość identyfikatora kolejki NDIS_DEFAULT_RECEIVE_QUEUE_ID, która określa domyślną kolejkę odbierania.
Kody stanu powrotu
Usługa NDIS obsługuje żądanie metody OID OID_RECEIVE_FILTER_ENUM_FILTERS dla sterowników miniportu i zwraca jeden z następujących kodów stanu:
NDIS_STATUS_SUCCESS
Żądanie zostało ukończone pomyślnie.
InformationBuffer wskazuje strukturę NDIS_RECEIVE_FILTER_INFO_ARRAY.
NDIS_STATUS_PENDING
Żądanie oczekuje na ukończenie. Usługa NDIS przekazuje końcowy kod stanu i wyniki do procedury obsługi żądań OID obiektu wywołującego po zakończeniu żądania.
NDIS_STATUS_INVALID_LENGTH
Bufor informacyjny był zbyt krótki. NDIS ustaw DATA. QUERY_INFORMATION. BajtyNowe składowe 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) |
Zobacz też
NDIS_RECEIVE_FILTER_INFO_ARRAY
OID_RECEIVE_FILTER_ALLOCATE_QUEUE