Udostępnij przez


OID_RECEIVE_FILTER_CURRENT_CAPABILITIES

Nadmierne sterowniki wydają żądania zapytań OID OID_RECEIVE_FILTER_CURRENT_CAPABILITIES, aby uzyskać obecnie włączone funkcje filtrowania odbierania karty sieciowej.

Po pomyślnym powrocie z żądania zapytania OID InformationBuffer struktury NDIS_OID_REQUEST zawiera wskaźnik do struktury NDIS_RECEIVE_FILTER_CAPABILITIES.

Uwagi

Filtry odbierania NDIS są używane w następujących interfejsach NDIS:

Począwszy od NDIS 6.20, sterowniki miniportu rejestrują obecnie włączone możliwości filtrowania sprzętu karty sieciowej, gdy jest wywoływana jej funkcja MiniportInitializeEx. Sterowniki miniportu rejestrują te możliwości, wykonując następujące czynności:

  1. Sterownik inicjuje strukturę NDIS_RECEIVE_FILTER_CAPABILITIES z aktualnie włączonymi możliwościami sprzętowymi filtrowania odbierania.

  2. Sterownik inicjuje strukturę NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES i ustawia element członkowski CurrentReceiveFilterCapabilities do wskaźnika do struktury NDIS_RECEIVE_FILTER_CAPABILITIES.

  3. Sterownik miniportu wywołuje funkcję NdisMSetMiniportAttributes i ustawia parametr MiniportAttributes do wskaźnika do struktury NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES.

Nadmierne protokoły i sterowniki filtrów nie muszą wystawiać żądań zapytań OID OID_RECEIVE_FILTER_CURRENT_CAPABILITIES. Usługa NDIS zapewnia obecnie włączone funkcje filtrowania odbierania dla tych sterowników w następujący sposób:

  • Usługa NDIS zapewnia obecnie włączone możliwości filtrowania odbierania podstawowej karty sieciowej do nadmiernych sterowników protokołów w ReceiveFilterCapabilities elementu członkowskiego struktury NDIS_BIND_PARAMETERS podczas operacji powiązania.

  • Funkcja NDIS zapewnia obecnie włączone możliwości filtrowania odbierania podstawowej karty sieciowej do nadmiernego filtrowania sterowników w ReceiveFilterCapabilities elementu członkowskiego struktury NDIS_FILTER_ATTACH_PARAMETERS podczas operacji dołączania.

Kody stanu powrotu

Usługa NDIS obsługuje żądanie zapytania OID OID_RECEIVE_FILTER_CURRENT_CAPABILITIES 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_CAPABILITIES.

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_NOT_SUPPORTED
Karta sieciowa nie obsługuje filtrowania odbierania.

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_BIND_PARAMETERS

NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES

NDIS_OID_REQUEST

NDIS_RECEIVE_FILTER_CAPABILITIES