OID_RECEIVE_FILTER_HARDWARE_CAPABILITIES
Nadměrné ovladače vydávají požadavky na dotazy OID OID_RECEIVE_FILTER_HARDWARE_CAPABILITIES, aby získaly hardwarové funkce 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 strukturuNDIS_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.
Struktura NDIS_RECEIVE_FILTER_CAPABILITIES obsahuje informace o hardwarových možnostech příjmu filtrování síťového adaptéru. Tyto možnosti mohou zahrnovat hardwarové funkce, které jsou aktuálně zakázány nastavením souboru INF nebo prostřednictvím stránky vlastností Upřesnit.
Poznámka Všechny hardwarové možnosti filtrování příjmu síťového adaptéru se vrátí prostřednictvím požadavku dotazu OID OID_RECEIVE_FILTER_HARDWARE_CAPABILITIES bez ohledu na to, jestli je funkce povolená nebo zakázaná.
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 možnostmi hardwaru příjmu filtrování.
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.
Vrácení stavových kódů
NDIS zpracovává požadavek dotazu OID OID_RECEIVE_FILTER_HARDWARE_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) |