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:
NDIS packet coalescing. Další informace o tom, jak používat filtry příjmu v tomto rozhraní, naleznete v tématu Správa paketů coalescing Receive Filters.
virtualizace vstupně-výstupních operací s jedním kořenem (SR-IOV). Další informace o použití filtrů příjmu v tomto rozhraní naleznete v tématu Nastavení filtru příjmu na virtuální port.
fronty virtuálních počítačů (VMQ). Další informace o tom, jak používat filtry příjmu v tomto rozhraní, naleznete v tématu Nastavení a vymazání filtrů VMQ.
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:
Ovladač inicializuje NDIS_RECEIVE_FILTER_CAPABILITIES strukturu s aktuálně povolenými možnostmi filtrování hardwaru.
Ovladač inicializuje NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES strukturu a nastaví CurrentReceiveFilterCapabilities člen na ukazatel na strukturu NDIS_RECEIVE_FILTER_CAPABILITIES.
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) |