Sdílet prostřednictvím


OID_RECEIVE_FILTER_CURRENT_CAPABILITIES

Nadměrné ovladače vydávají požadavky na dotazy OID OID_RECEIVE_FILTER_CURRENT_CAPABILITIES k získání aktuálně povolených možností filtrování příjmu síťového adaptéru.

Po úspěšném návratu z požadavku dotazu OID obsahuje InformationBuffer člen struktury NDIS_OID_REQUEST ukazatel na strukturu NDIS_RECEIVE_FILTER_CAPABILITIES.

Poznámky

Filtry příjmu NDIS se používají v následujících rozhraních NDIS:

Počínaje verzí NDIS 6.20 registrují ovladače miniportu aktuálně povolené hardwarové možnosti filtrování hardwaru síťového adaptéru, když je volána jeho MiniportInitializeEx funkce. Ovladače miniportu registrují tyto funkce pomocí následujícího postupu:

  1. Ovladač inicializuje NDIS_RECEIVE_FILTER_CAPABILITIES strukturu s aktuálně povolenými možnostmi filtrování hardwaru.

  2. Ovladač inicializuje NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES strukturu a nastaví CurrentReceiveFilterCapabilities člen na ukazatel na strukturu NDIS_RECEIVE_FILTER_CAPABILITIES.

  3. Ovladač miniportu volá funkciNdisMSetMiniportAttributes a nastaví MiniportAttributes parametr na ukazatel na NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES strukturu.

Přílišné ovladače protokolu a filtru nemusí vydávat požadavky na dotazy OID OID_RECEIVE_FILTER_CURRENT_CAPABILITIES. NDIS poskytuje aktuálně povolené možnosti filtrování pro tyto ovladače následujícím způsobem:

  • NDIS poskytuje aktuálně povolené možnosti filtrování příjmu základního síťového adaptéru tak, aby v ReceiveFilterCapabilities člen struktury NDIS_BIND_PARAMETERS během operace vazby.

  • NDIS poskytuje aktuálně povolené možnosti filtrování příjmu základního síťového adaptéru pro nadměrné filtrování ovladačů v ReceiveFilterCapabilities člen struktury NDIS_FILTER_ATTACH_PARAMETERS během operace připojení.

Vrácení stavových kódů

NDIS zpracovává požadavek dotazu OID OID_RECEIVE_FILTER_CURRENT_CAPABILITIES pro ovladače miniportu a vrací jeden z následujících stavových kódů:

NDIS_STATUS_SUCCESS
Žádost byla úspěšně dokončena. InformationBuffer odkazuje na strukturu NDIS_RECEIVE_FILTER_CAPABILITIES.

NDIS_STATUS_PENDING
Požadavek čeká na dokončení. NDIS předá konečný stavový kód a výsledky obslužné rutině dokončení požadavku OID volajícího po dokončení požadavku.

NDIS_STATUS_INVALID_LENGTH
Informační vyrovnávací paměť byla příliš krátká. NDIS nastavil DATA. QUERY_INFORMATION. BytesNeeded člen ve struktuře NDIS_OID_REQUEST na minimální požadovanou velikost vyrovnávací paměti.

NDIS_STATUS_NOT_SUPPORTED
Síťový adaptér nepodporuje filtrování.

NDIS_STATUS_FAILURE
Žádost se nezdařila z jiných důvodů.

Požadavky

Verze

Podporováno v NDIS 6.20 a novějších verzích.

Záhlaví

Ntddndis.h (včetně Ndis.h)

Viz také

NDIS_BIND_PARAMETERS

NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES

NDIS_OID_REQUEST

NDIS_RECEIVE_FILTER_CAPABILITIES