Udostępnij przez


OID_RECEIVE_FILTER_HARDWARE_CAPABILITIES

Nadmierne sterowniki wystawiają żądania zapytań OID OID_RECEIVE_FILTER_HARDWARE_CAPABILITIES w celu uzyskania możliwości sprzętu filtrowania odbierania karty sieciowej.

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

Uwagi

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

Struktura NDIS_RECEIVE_FILTER_CAPABILITIES zawiera informacje o możliwościach sprzętowych filtrowania odbieranych przez kartę sieciową. Te możliwości mogą obejmować możliwości sprzętowe, które są obecnie wyłączone przez ustawienia pliku INF lub za pośrednictwem strony właściwości Zaawansowane.

Uwaga Wszystkie możliwości sprzętowe filtrowania odbierania karty sieciowej są zwracane za pośrednictwem żądania zapytania OID OID_RECEIVE_FILTER_HARDWARE_CAPABILITIES, niezależnie od tego, czy funkcja jest włączona, czy wyłączona.

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 możliwościami sprzętu filtrowania odbierającego.

  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.

Kody stanu powrotu

Usługa NDIS obsługuje żądanie zapytania OID OID_RECEIVE_FILTER_HARDWARE_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 uzupełniania żą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