OID_RECEIVE_FILTER_HARDWARE_CAPABILITIES
Överdrivande drivrutiner utfärdar OID-frågebegäranden för OID_RECEIVE_FILTER_HARDWARE_CAPABILITIES för att hämta maskinvarufunktionerna för att ta emot filtrering av ett nätverkskort.
Efter en lyckad retur från OID-frågebegäran innehåller InformationBuffer medlem i NDIS_OID_REQUEST-strukturen en pekare till enNDIS_RECEIVE_FILTER_CAPABILITIES struktur.
Anmärkningar
NDIS-mottagningsfilter används i följande NDIS-gränssnitt:
NDIS-paket som samlar. Mer information om hur du använder ta emot filter i det här gränssnittet finns i Hantera paketkolescing ta emot filter.
I/O-virtualisering med enkel rot (SR-IOV). Mer information om hur du använder mottagningsfilter i det här gränssnittet finns i Ange ett mottagningsfilter på en virtuell port.
VMQ (Virtual Machine Queue). Mer information om hur du använder mottagningsfilter i det här gränssnittet finns i Inställning och Rensa VMQ-filter.
Den NDIS_RECEIVE_FILTER_CAPABILITIES strukturen innehåller information om maskinvarufunktionerna för att ta emot filtrering i ett nätverkskort. Dessa funktioner kan omfatta maskinvarufunktioner som för närvarande är inaktiverade av INF-filinställningar eller via egenskapssidan Avancerade.
Obs Alla maskinvarufunktioner för mottagarfiltrering i ett nätverkskort returneras via en OID-frågebegäran av OID_RECEIVE_FILTER_HARDWARE_CAPABILITIES, oavsett om en funktion är aktiverad eller inaktiverad.
Från och med NDIS 6.20 registrerar miniportdrivrutiner de för närvarande aktiverade funktionerna för filtrering av maskinvarufunktioner för nätverkskortet när dess MiniportInitializeEx-funktion anropas. Miniportdrivrutiner registrerar dessa funktioner genom att följa dessa steg:
Drivrutinen initierar en NDIS_RECEIVE_FILTER_CAPABILITIES struktur med maskinvarufunktionerna för mottagarfiltrering.
Drivrutinen initierar en NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES struktur och anger CurrentReceiveFilterCapabilities medlem till en pekare till NDIS_RECEIVE_FILTER_CAPABILITIES struktur.
Miniportdrivrutinen anropar funktionen NdisMSetMiniportAttributes och anger parametern MiniportAttributes till en pekare till en NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES struktur.
Returnera statuskoder
NDIS hanterar OID-frågebegäran för OID_RECEIVE_FILTER_HARDWARE_CAPABILITIES för miniportdrivrutiner och returnerar någon av följande statuskoder:
NDIS_STATUS_SUCCESS
Begäran har slutförts.
InformationBuffer pekar på en NDIS_RECEIVE_FILTER_CAPABILITIES struktur.
NDIS_STATUS_PENDING
Begäran väntar på att slutföras. NDIS skickar den slutliga statuskoden och resultaten till OID-begärans slutförandehanterare för anroparen när begäran har slutförts.
NDIS_STATUS_INVALID_LENGTH
Informationsbufferten var för kort. NDIS anger DATA. QUERY_INFORMATION. BytesNeeded medlem i NDIS_OID_REQUEST struktur till den minsta buffertstorlek som krävs.
NDIS_STATUS_NOT_SUPPORTED
Nätverkskortet stöder inte mottagningsfiltrering.
NDIS_STATUS_FAILURE
Begäran misslyckades av andra skäl.
Krav
Version |
Stöds i NDIS 6.20 och senare. |
Rubrik |
Ntddndis.h (inkludera Ndis.h) |