Auf Englisch lesen

Freigeben über


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)

Weitere Informationen


NDIS_NIC_SWITCH_VF_PARAMETERS

NDIS_OID_REQUEST

OID_NIC_SWITCH_ALLOCATE_VF

OID_NIC_SWITCH_ENUM_VFS

NDIS_NIC_SWITCH_VF_INFO

OID_NIC_SWITCH_VF_PARAMETERS