OID_SRIOV_BAR_RESOURCES
NDIS utfärdar en OID-metodbegäran (object identifier) för OID_SRIOV_BAR_RESOURCES för att fastställa de minnesresurser som allokerades till ett PCI Express-basadressregister (PCIe) för en virtuell PCIe-funktion (VF).
NDIS utfärdar denna OID-metodbegäran till miniportdrivrutinen för nätverkskortets PCIe Physical Function (PF). Den här OID-metodbegäran krävs för PF-miniportdrivrutiner som stöder gränssnittet för enkel rot-I/O-virtualisering (SR-IOV).
InformationBuffer medlem i NDIS_OID_REQUEST-strukturen innehåller en pekare till en buffert. Den här bufferten innehåller följande strukturer:
En NDIS_SRIOV_BAR_RESOURCES_INFO struktur som anger den VF och BAR som PF-miniportdrivrutinen returnerar resursinformation för.
En CM_PARTIAL_RESOURCE_DESCRIPTOR struktur som följer den NDIS_SRIOV_BAR_RESOURCES_INFO strukturen. Den CM_PARTIAL_RESOURCE_DESCRIPTOR strukturen innehåller information om de minnesresurser som allokerades till den angivna STAPELN.
NDIS utfärdar en OID-metodbegäran av OID_SRIOV_BAR_RESOURCES för att hämta systemets fysiska adress och längden på de minnesresurser som allokerats till en VF BAR. Innan OID-metodbegäran skickas formaterar NDIS NDIS_SRIOV_BAR_RESOURCES_INFO struktur på följande sätt:
NDIS anger VFId medlem i NDIS_SRIOV_BAR_RESOURCES_INFO struktur till identifieraren som är associerad med den virtuella hårddisken.
NDIS anger BarIndex medlem i NDIS_SRIOV_BAR_RESOURCES_INFO struktur till BAR-indexet för den angivna virtuella hårddisken. BAR-indexet är förskjutningen av registret i tabellen med BAR i PCI-konfigurationsutrymmet.
NDIS anger BarResourcesOffset medlem i NDIS_SRIOV_BAR_RESOURCES_INFO struktur till förskjutningen, i byteenheter, från början av NDIS_SRIOV_BAR_RESOURCES_INFO struktur till en CM_PARTIAL_RESOURCE_DESCRIPTOR struktur.
Observera Överförbrukningsdrivrutiner, till exempel protokoll- eller filterdrivrutiner, kan inte utfärda OID-metodbegäranden för OID_SRIOV_BAR_RESOURCES till PF-miniportdrivrutinen.
När PF-miniportdrivrutinen tar emot OID-metodbegäran returnerar drivrutinen resurserna för den angivna stapeln genom att formatera CM_PARTIAL_RESOURCE_DESCRIPTOR struktur i InformationBuffer medlem i NDIS_OID_REQUEST struktur. Drivrutinen formaterar den CM_PARTIAL_RESOURCE_DESCRIPTOR strukturen med de systemmaskinvararesurser som är associerade med FÄLTET för den angivna virtuella hårddisken.
Obs Drivrutinen måste formatera strukturen för en resurstyp av CmResourceTypeMemory.
PF-miniportdrivrutinen returnerar någon av följande statuskoder för metodbegäran för OID_SRIOV_BAR_RESOURCES.
| 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_BAR_RESOURCES_INFO struktur har ogiltiga värden. |
NDIS_STATUS_INVALID_LENGTH |
Informationsbufferten är mindre än (sizeof(NDIS_SRIOV_BAR_RESOURCES_INFO) + sizeof(CM_PARTIAL_RESOURCE_DESCRIPTOR). PF-miniportdrivrutinen måste ange 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. |
Version |
Stöds i NDIS 6.30 och senare. |
Rubrik |
Ntddndis.h (inkludera Ndis.h) |