OID_NIC_SWITCH_ENUM_VPORTS
En överliggande drivrutin eller ett program i användarläge utfärdar en OID-metodbegäran (object identifier) för OID_NIC_SWITCH_ENUM_VPORTS för att hämta en matris. Varje element i matrisen anger attributen för en virtuell port (VPort) som har skapats på nätverkskortets nätverkskortsväxel.
Efter en lyckad retur från den här OID-frågebegäran innehåller InformationBuffer medlem i NDIS_OID_REQUEST-strukturen en pekare till en buffert som innehåller följande:
En NDIS_NIC_SWITCH_VPORT_INFO_ARRAY struktur som definierar antalet element i matrisen.
En matris med NDIS_NIC_SWITCH_VPORT_INFO strukturer. Var och en av dessa strukturer innehåller information om en VPort på nätverkskortets nätverkskorts NIC-växel.
Obs Om inga VPorts har skapats på nätverkskortet anger drivrutinen NumElements medlem i NDIS_NIC_SWITCH_VPORT_INFO_ARRAY-strukturen till noll och inga NDIS_NIC_SWITCH_VPORT_INFO strukturer returneras.
Anmärkningar
Överliggande drivrutiner och program i användarläge utfärdar OID-frågebegäranden för OID_NIC_SWITCH_ENUM_VPORTS för att räkna upp de virtuella portar som allokeras på nätverkskortets nätverkskortsväxel.
Innan drivrutinen eller programmet utfärdar OID-begäran måste den initiera en NDIS_NIC_SWITCH_VPORT_INFO_ARRAY struktur som skickas tillsammans med begäran. Drivrutinen eller programmet måste följa dessa riktlinjer när NDIS_NIC_SWITCH_VPORT_INFO_ARRAY struktur initieras:
Om flaggan NDIS_NIC_SWITCH_VPORT_INFO_ARRAY_ENUM_ON_SPECIFIC_SWITCH anges i Flags-medlemmen returneras information för alla VPorts som skapats på en angiven NIC-växel. NIC-växeln anges av SwitchId medlem i den strukturen.
Observera Från och med Windows Server 2012 stöder SR-IOV-gränssnittet endast standardknappen för nätverkskort. Oavsett vilka flaggor som anges i Flags-medlemmen måste SwitchId-medlemmen anges till NDIS_DEFAULT_SWITCH_ID.
Om flaggan NDIS_NIC_SWITCH_VPORT_INFO_ARRAY_ENUM_ON_SPECIFIC_FUNCTION anges i Flags-medlemmen returneras information för alla VPorts som är kopplade till en angiven FYSISK PCI Express-funktion (PCIe) eller virtuell funktion (VF) på nätverkskortet. PF eller VF anges av AttachedFunctionId medlem i den strukturen.
Om AttachedFunctionId medlem är inställd på NDIS_PF_FUNCTION_ID returneras information för alla VPorts, inklusive standard-VPort, som är anslutna till nätverkskortets PF. Om AttachedFunctionId medlem har angetts till en giltig VF-identifierare returneras information för alla VPorts till den angivna virtuella hårddisken.
Observera Från och med Windows Server 2012 kan endast en nondefault VPort kopplas till en virtuell hårddisk. Flera VPorts (inklusive standard-VPort) kan dock kopplas till PF.
Om Flags-medlemmen är inställd på noll returneras information för alla VPorts som är kopplade till PF eller VF på nätverkskortet. I det här fallet ignoreras värdena för SwitchId och AttachedFunctionId.
Mer information finns i Räkna upp virtuella portar på ett nätverkskort.
Returstatuskoder
NDIS hanterar OID-metodbegäran för OID_NIC_SWITCH_ENUM_VPORTS begäran för miniportdrivrutiner. Drivrutinerna kommer inte att utfärdas den här OID-begäran.
När NDIS hanterar OID_NIC_SWITCH_ENUM_VPORTS 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_PARAMETER |
En eller flera medlemmar i NDIS_NIC_SWITCH_VF_INFO_ARRAY struktur har ogiltiga värden. |
NDIS_STATUS_INVALID_LENGTH |
Informationsbufferten var för kort. NDIS anger DATA. METHOD_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) |