Dela via


OID_SRIOV_CURRENT_CAPABILITIES

En överliggande drivrutin utfärdar en OID-frågebegäran (object identifier) för OID_SRIOV_CURRENT_CAPABILITIES för att hämta de aktuella funktionerna för enkel rot-I/O-virtualisering (SR-IOV) för ett nätverkskort.

InformationBuffer medlem i NDIS_OID_REQUEST struktur innehåller en pekare till NDIS_SRIOV_CAPABILITIES struktur.

Anmärkningar

Från och med NDIS 6.30 tillhandahåller miniportdrivrutiner de aktiverade SR-IOV maskinvarufunktionerna på nätverkskortet när dess MiniportInitializeEx-funktion anropas. Drivrutinen initierar en NDIS_SRIOV_CAPABILITIES struktur med de för närvarande aktiverade SR-IOV maskinvarufunktionerna och anger CurrentSriovCapabilities medlem i NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES-strukturen till en pekare till NDIS_SRIOV_CAPABILITIES struktur. Miniportdrivrutinen anropar sedan funktionen NdisMSetMiniportAttributes och anger parametern MiniportAttributes till en pekare till en NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES struktur.

För mycket protokoll- och filterdrivrutiner behöver inte utfärda OID-frågebegäranden för OID_SRIOV_CURRENT_CAPABILITIES. NDIS tillhandahåller de för närvarande aktiverade SR-IOV funktionerna i ett nätverkskort till dessa drivrutiner på följande sätt:

  • NDIS rapporterar de för närvarande aktiverade SR-IOV funktionerna i ett underliggande nätverkskort till överliggande protokolldrivrutiner i SriovCapabilities medlem i NDIS_BIND_PARAMETERS struktur under bindningsåtgärden.

  • NDIS rapporterar de för närvarande aktiverade SR-IOV funktionerna i ett underliggande nätverkskort till överliggande filterdrivrutiner i SriovCapabilities medlem i NDIS_FILTER_ATTACH_PARAMETERS-strukturen under anslutningsåtgärderna.

Returstatuskoder

NDIS hanterar OID-frågebegäran för OID_SRIOV_CURRENT_CAPABILITIES begäran för miniportdrivrutiner. Drivrutinerna kommer inte att utfärdas den här OID-begäran.

När NDIS hanterar OID_SRIOV_CURRENT_CAPABILITIES begäran returneras någon av följande statuskoder:

Statuskod Beskrivning

NDIS_STATUS_SUCCESS

OID-begäran har slutförts.

NDIS_STATUS_NOT_SUPPORTED

Miniportdrivrutinen stöder antingen inte det enda rot-I/O-virtualiseringsgränssnittet (SR-IOV) eller så är den inte aktiverad för att använda gränssnittet.

NDIS_STATUS_INVALID_LENGTH

Informationsbufferten var för kort. Miniportdrivrutinen måste ange DATA. QUERY_INFORMATION. BytesNeeded medlem i NDIS_OID_REQUEST struktur till den minsta buffertstorlek som krävs.

NDIS_STATUS_FAILURE

Begäran misslyckades av andra skäl.

Krav

Version

Stöds i NDIS 6.30 och senare.

Rubrik

Ntddndis.h (inkludera Ndis.h)

Se även


NDIS_BIND_PARAMETERS

NDIS_FILTER_ATTACH_PARAMETERS

NDIS_OID_REQUEST

NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES

NDIS_SRIOV_CAPABILITIES

NdisMSetMiniportAttributes