OID_SRIOV_VF_VENDOR_DEVICE_ID
Ein Überlastungstreiber gibt eine Objektbezeichner-Methodenanforderung von OID_SRIOV_VF_VENDOR_DEVICE_ID aus, um den PCI Express (PCIe)-Gerätebezeichner (DeviceID) und vendor identifier (VendorID) für einen PCI Express (PCIe) Virtual Function (VF)-Netzwerkadapter abzufragen. Dieser virtuelle Netzwerkadapter wird in der untergeordneten Hyper-V-Partition verfügbar gemacht, die an die VF angefügt ist.
Überlastende Treiber stellen diese Anforderung der OID-Methode an den Miniporttreiber des PCI Express (PCIe) Physical Function (PF) des Netzwerkadapters aus. Diese Anforderung der OID-Methode ist für PF-Miniporttreiber erforderlich, die die SR-IOV-Schnittstelle (Single Root E/O Virtualization) unterstützen.
Das InformationBuffer-Element der NDIS_OID_REQUEST-Struktur enthält einen Zeiger auf eine NDIS_SRIOV_VF_VENDOR_DEVICE_ID_INFO-Struktur .
Bemerkungen
Bevor er diese OID-Methodenanforderung ausgibt, muss der überlastende Treiber eine NDIS_SRIOV_VF_VENDOR_DEVICE_ID_INFO-Struktur initialisieren und den VFId-Member auf den Bezeichner des VF festlegen, aus dem die Informationen gelesen werden sollen.
Wenn er diese OID-Anforderung verarbeitet, muss der PF-Miniporttreiber überprüfen, ob der angegebene VF über Ressourcen verfügt, die zuvor zugewiesen wurden. Der PF-Miniporttreiber weist ressourcen für eine VF während einer OID-Methodenanforderung von OID_NIC_SWITCH_ALLOCATE_VF zu. Wenn ressourcen für die angegebene VF nicht zugewiesen wurden, muss der Treiber die OID-Anforderung nicht ausführen.
Weitere Informationen finden Sie unter Abfragen des PCI-Anbieters und gerätebezeichners für eine virtuelle Funktion.
Rückgabestatuscodes
Der PF-Miniporttreiber gibt einen der folgenden status Codes für die OID-Methodenanforderung von OID_SRIOV_VF_VENDOR_DEVICE_ID zurück.
| Statuscode | BESCHREIBUNG |
|---|---|
NDIS_STATUS_SUCCESS |
Die OID-Anforderung wurde erfolgreich abgeschlossen. |
NDIS_STATUS_NOT_SUPPORTED |
Der PF-Miniporttreiber unterstützt entweder nicht die SR-IOV-Schnittstelle (Single Root E/O Virtualization) oder ist für die Verwendung der Schnittstelle nicht aktiviert. |
NDIS_STATUS_INVALID_PARAMETER |
Mindestens ein Member der NDIS_SRIOV_VF_VENDOR_DEVICE_ID_INFO-Struktur weisen ungültige Werte auf. |
NDIS_STATUS_INVALID_LENGTH |
Der Informationspuffer war zu kurz. NDIS legt die DATEN fest. METHOD_INFORMATION. BytesNeed-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) |