OID_SRIOV_RESET_VF
Överliggande drivrutiner utfärdar en begäran om objektidentifierare (OID) för OID_SRIOV_RESET_VF för att återställa en angiven virtuell PCI Express-funktion (PCIe) på ett nätverkskort som stöder enkel rot-I/O-virtualisering. Överdrivande drivrutiner utfärdar denna OID-uppsättningsbegäran till miniportdrivrutinen för PCI Express (PCIe) Physical Function (PF) för nätverkskortet.
InformationBuffer medlem i NDIS_OID_REQUEST struktur innehåller en pekare till en NDIS_SRIOV_RESET_VF_PARAMETERS struktur. Den överdrivande drivrutinen anger identifieraren för den VF som ska återställas via VFId medlem i den här strukturen.
Anmärkningar
En virtuell hårddisk kan återställas via en PCI Express-funktionsnivååterställning (FLR). Eftersom FLR-begäran är en privilegierad åtgärd kan den bara utföras av PF-miniportdrivrutinen som körs i hanteringsoperativsystemet för en Hyper-V överordnad partition. Överdrivna drivrutiner som körs i hanteringsoperativsystemet meddelas om FLR-begäran och utfärdar OID-uppsättningens begäran om OID_SRIOV_RESET_VF till PF-miniportdrivrutinen.
När den hanterar den här OID-begäran måste PF-miniportdrivrutinen följa dessa riktlinjer:
PF-miniportdrivrutinen måste kontrollera att den virtuella hårddisken, som anges av VFId medlem i NDIS_SRIOV_RESET_VF_PARAMETERS struktur, har resurser som tidigare har allokerats. PF-miniportdrivrutinen allokerar resurser för en VF under en OID-metodbegäran av OID_NIC_SWITCH_ALLOCATE_VF. Om resurser för den angivna virtuella hårddisken inte har allokerats måste drivrutinen misslyckas med OID-begäran.
Återställningsåtgärden får endast påverka den angivna virtuella hårddisken. Åtgärden får inte påverka andra virtuella datorer eller PF på samma nätverkskort.
Mer information finns i Återställa en virtuell funktion.
Returstatuskoder
PF-miniportdrivrutinen returnerar någon av följande statuskoder för den angivna begäran om OID_SRIOV_RESET_VF.
Statuskod | Beskrivning |
---|---|
NDIS_STATUS_SUCCESS |
OID-begäran har slutförts. |
NDIS_STATUS_NOT_SUPPORTED |
PF-miniportdrivrutinen stöder antingen inte det enskilda 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 av medlemmarna i NDIS_SRIOV_RESET_VF_PARAMETERS struktur har ogiltiga värden. |
NDIS_STATUS_INVALID_LENGTH |
Informationsbufferten var för kort. PF-miniportdrivrutinen måste ange DATA. SET_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) |