Poznámka
Přístup k této stránce vyžaduje autorizaci. Můžete se zkusit přihlásit nebo změnit adresáře.
Přístup k této stránce vyžaduje autorizaci. Můžete zkusit změnit adresáře.
Přílišný ovladač vydá žádost o metodu OID OID_RECEIVE_FILTER_PARAMETERS k získání aktuálních parametrů konfigurace filtru na síťovém adaptéru.
InformationBuffer člen struktury NDIS_OID_REQUEST obsahuje ukazatel na NDIS_RECEIVE_FILTER_PARAMETERS strukturu. NDIS používá FilterId člen ve vstupní struktuře k identifikaci filtru.
Po úspěšném návratu z požadavku metody OID obsahuje InformationBuffer člen struktury NDIS_OID_REQUEST obsahuje ukazatel na vyrovnávací paměť. Tato vyrovnávací paměť je formátovaná tak, aby obsahovala následující:
Struktura NDIS_RECEIVE_FILTER_PARAMETERS, která určuje parametry pro filtr příjmu NDIS.
Pole NDIS_RECEIVE_FILTER_FIELD_PARAMETERS struktur, které určují kritérium testu filtru pro pole v hlavičce síťového paketu.
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.
Přílišné ovladače vydávají žádosti o metodu OID OID_RECEIVE_FILTER_PARAMETERS získat konfigurační parametry pro filtr příjmu nastavený na síťovém adaptéru. To zahrnuje filtr příjmu nastavený na frontě příjmu VMQ nebo SR-IOV virtuální port (VPort) a také filtr pro služení paketů stažený do ovladače miniportu.
Přílišný ovladač získal identifikátor filtru z dřívějšího požadavku metody OID OID_RECEIVE_FILTER_SET_FILTER nebo z požadavků OID OID_RECEIVE_FILTER_ENUM_FILTERS.
Vrácení stavových kódů
NDIS zpracovává požadavek OID OID_RECEIVE_FILTER_PARAMETERS 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_PARAMETERS.
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_PARAMETER
Přílišný ovladač nebo aplikace poskytly neplatný identifikátor filtru. Identifikátor filtru není platný, pokud je nulový nebo pokud určuje nedefinovaný filtr.
NDIS_STATUS_INVALID_LENGTH
Informační vyrovnávací paměť byla příliš krátká. Rozhraní NDIS nastaví DATA. QUERY_INFORMATION. BytesNeeded člen ve struktuře NDIS_OID_REQUEST na minimální požadovanou velikost vyrovnávací paměti.
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é
OID_RECEIVE_FILTER_ENUM_FILTERS