Dela via


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:

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:

  1. Drivrutinen initierar en NDIS_RECEIVE_FILTER_CAPABILITIES struktur med maskinvarufunktionerna för mottagarfiltrering.

  2. Drivrutinen initierar en NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES struktur och anger CurrentReceiveFilterCapabilities medlem till en pekare till NDIS_RECEIVE_FILTER_CAPABILITIES struktur.

  3. 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)

Se även

NDIS_BIND_PARAMETERS

NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES

NDIS_OID_REQUEST

NDIS_RECEIVE_FILTER_CAPABILITIES