OID_NIC_SWITCH_VF_PARAMETERS
Ein überlastender Treiber oder eine Benutzermodusanwendung gibt eine OID-Methodenanforderung (Object Identifier) von OID_NIC_SWITCH_VF_PARAMETERS aus, um die aktuellen Konfigurationsparameter einer PCI Express (PCIe) Virtual Function (VF) auf einem Netzwerkadapter abzurufen. Nur VFs, denen Ressourcen über eine OID-Methodenanforderung von OID_NIC_SWITCH_ALLOCATE_VF zugeordnet sind, können über eine OID-Methodenanforderung von OID_NIC_SWITCH_VF_PARAMETERS abgefragt werden.
NDIS verarbeitet die OID-Methodenanforderung von OID_NIC_SWITCH_VF_PARAMETERS für Miniporttreiber.
Wenn die OID-Methodenanforderung gestellt wird, enthält das InformationBuffer-Element der NDIS_OID_REQUEST-Struktur einen Zeiger auf eine NDIS_NIC_SWITCH_VF_PARAMETERS-Struktur .
Bemerkungen
Der überstehende Treiber oder die Benutzermodusanwendung gibt den abzufragenden VF an, indem der VFId-Member der NDIS_NIC_SWITCH_VF_PARAMETERS-Struktur auf den Bezeichner des VF festgelegt wird. Der überlastende Treiber oder die anwendung ruft den VF-Bezeichner über eine der folgenden Methoden ab:
Durch Ausstellen einer OID-Methodenanforderung von OID_NIC_SWITCH_ENUM_VFS.
Wenn diese OID-Anforderung erfolgreich abgeschlossen wurde, empfängt der überlastende Treiber oder die Benutzermodusanwendung eine Liste aller VFs, die dem Netzwerkadapter zugeordnet sind. Jedes Element in der Liste ist eine NDIS_NIC_SWITCH_VF_INFO-Struktur , wobei der VF-Bezeichner vom VFId-Element angegeben wird.
Durch Ausstellen einer OID-Methodenanforderung von OID_NIC_SWITCH_ALLOCATE_VF.
Wenn diese OID-Anforderung erfolgreich abgeschlossen wurde, empfängt der überstehende Treiber den Bezeichner des neu erstellten VF im VFId-Member der zurückgegebenen NDIS_NIC_SWITCH_VF_PARAMETERS-Struktur .
Hinweis Nur überlastende Treiber können den VF-Bezeichner auf diese Weise abrufen.
Nach einer erfolgreichen Rückgabe von der OID-Methodenanforderung enthält der InformationBuffer-Member der NDIS_OID_REQUEST-Struktur einen Zeiger auf eine NDIS_NIC_SWITCH_VF_PARAMETERS-Struktur . Diese Struktur enthält die Konfigurationsparameter für den angegebenen VF.
Zurückgeben von Statuscodes
NDIS verarbeitet die OID-Methodenanforderung von OID_NIC_SWITCH_VF_PARAMETERS für Miniporttreiber und gibt den folgenden status Code für OID-Methodenanforderungen von OID_NIC_SWITCH_VF_PARAMETERS zurück.
| Statuscode | BESCHREIBUNG |
|---|---|
NDIS_STATUS_SUCCESS |
Die Anforderung wurde erfolgreich abgeschlossen. Das InformationBuffer-Element verweist auf eine NDIS_NIC_SWITCH_VF_PARAMETERS-Struktur . |
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_PARAMETER |
Mindestens ein Member der NDIS_NIC_SWITCH_VF_PARAMETERS-Struktur hat ungültige Werte. |
NDIS_STATUS_INVALID_LENGTH |
Die Länge des Informationspuffers ist kleiner als sizeof(NDIS_NIC_SWITCH_VF_PARAMETERS). NDIS legt die DATEN fest. METHOD_INFORMATION. BytesNeeded-Member in der NDIS_OID_REQUEST Struktur auf die erforderliche Mindestpuffergröße. |
NDIS_STATUS_INVALID_LENGTH |
Der Informationspuffer war zu kurz. NDIS legt die DATEN fest. METHOD_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) |