OID_SRIOV_VF_SERIAL_NUMBER
Ein übersteigender Treiber gibt eine Objektbezeichnerabfrageanforderung (Object Identifier, OID) von OID_SRIOV_VF_SERIAL_NUMBER aus, um die Seriennummer des PCI Express (PCIe) Virtual Function (VF)-Netzwerkadapters zu ermitteln. Dieser virtuelle Netzwerkadapter wird im Gastbetriebssystem einer untergeordneten Hyper-V-Partition verfügbar gemacht, an die der VF angefügt ist.
Der InformationBuffer-Member der NDIS_OID_REQUEST-Struktur enthält einen Zeiger auf eine NDIS_SRIOV_VF_SERIAL_NUMBER_INFO-Struktur .
Bemerkungen
Der übersteigende Treiber verwendet die Seriennummer, um den VF-Netzwerkadapter einem instance eines VF auf dem physischen Netzwerkadapter zuzuordnen. Die Seriennummer wird vom Virtualisierungsstapel generiert, bevor Ressourcen für den VF über eine OID-Satzanforderung von OID_NIC_SWITCH_ALLOCATE_VF zugeordnet werden.
Zurückgeben von Statuscodes
NDIS verarbeitet die OID-Abfrageanforderung der OID_SRIOV_VF_SERIAL_NUMBER-Anforderung für Miniporttreiber. Die Treiber erhalten diese OID-Anforderung nicht.
Wenn NDIS die OID_SRIOV_VF_SERIAL_NUMBER-Anforderung verarbeitet, gibt sie einen der folgenden status-Codes zurück.
| Statuscode | BESCHREIBUNG |
|---|---|
NDIS_STATUS_SUCCESS |
Die OID-Anforderung wurde erfolgreich abgeschlossen. |
NDIS_STATUS_NOT_SUPPORTED |
Der Miniporttreiber unterstützt entweder nicht die SR-IOV-Schnittstelle (Single Root I/O Virtualization) oder ist nicht für die Verwendung der Schnittstelle aktiviert. |
NDIS_STATUS_INVALID_LENGTH |
Der Informationspuffer war zu kurz. NDIS legt die DATEN fest. QUERY_INFORMATION. BytesNeeded-Member in der NDIS_OID_REQUEST Struktur auf die erforderliche Mindestpuffergröße. |
NDIS_STATUS_FAILURE |
Die Anforderung ist aus anderen Gründen fehlgeschlagen. |
Requirements (Anforderungen)
Version |
Unterstützt in NDIS 6.30 und höher. |
Header |
Ntddndis.h (include Ndis.h) |