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