Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Ein übermäßiger Treiber oder eine Benutzermodusanwendung gibt eine OID-Methodenanforderung (Object Identifier) von OID_NIC_SWITCH_VF_PARAMETERS aus, um die aktuellen Konfigurationsparameter einer VIRTUELLEN PCI Express-Funktion (PCIe) auf einem Netzwerkadapter abzurufen. Nur VFs, die ü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 Member der NDIS_OID_REQUEST-Struktur einen Zeiger auf eine NDIS_NIC_SWITCH_VF_PARAMETERS Struktur.
Bemerkungen
Die überlagerte Treiber- oder Benutzermodusanwendung gibt den VF an, der abfragen soll, indem die VFId Mitglied der NDIS_NIC_SWITCH_VF_PARAMETERS-Struktur auf den Bezeichner des VF festgelegt wird. Der übersteigende Treiber oder die Anwendung ruft den VF-Bezeichner auf eine der folgenden Arten ab:
Durch Ausstellen einer OID-Methodenanforderung von OID_NIC_SWITCH_ENUM_VFS.
Wenn diese OID-Anforderung erfolgreich abgeschlossen wurde, empfängt die übermäßig aktive Treiber- oder Benutzermodusanwendung eine Liste aller VFs, die auf dem Netzwerkadapter zugeordnet sind. Jedes Element in der Liste ist eine NDIS_NIC_SWITCH_VF_INFO Struktur, wobei der VF-Bezeichner, der durch das VFId Member angegeben wird.
Durch Ausstellen einer OID-Methodenanforderung von OID_NIC_SWITCH_ALLOCATE_VF.
Wenn diese OID-Anforderung erfolgreich abgeschlossen wurde, empfängt der übersteigende Treiber den Bezeichner des neu erstellten VF in der VFId Member der zurückgegebenen NDIS_NIC_SWITCH_VF_PARAMETERS Struktur.
Hinweis Nur übermäßig viele Treiber können den VF-Bezeichner auf diese Weise abrufen.
Nach einer erfolgreichen Rückgabe aus der OID-Methodenanforderung enthält das InformationBuffer-element 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.
Rückgabestatuscodes
NDIS behandelt die OID-Methodenanforderung von OID_NIC_SWITCH_VF_PARAMETERS für Miniporttreiber und gibt den folgenden Statuscode für OID-Methodenanforderungen von OID_NIC_SWITCH_VF_PARAMETERS zurück.
| Statuscode | Beschreibung |
|---|---|
NDIS_STATUS_SUCCESS |
Die Anforderung wurde erfolgreich abgeschlossen. Das InformationBuffer Member verweist auf eine NDIS_NIC_SWITCH_VF_PARAMETERS Struktur. |
NDIS_STATUS_NOT_SUPPORTED |
Der Miniporttreiber unterstützt weder die einzelne I/O-Virtualisierungsschnittstelle (SR-IOV) noch ist die Verwendung der Schnittstelle aktiviert. |
NDIS_STATUS_INVALID_PARAMETER |
Mindestens ein Element der NDIS_NIC_SWITCH_VF_PARAMETERS-Struktur hat ungültige Werte. |
NDIS_STATUS_INVALID_LENGTH |
Die Länge des Informationspuffers ist kleiner als die Größe(NDIS_NIC_SWITCH_VF_PARAMETERS). NDIS legt die DATA fest. METHOD_INFORMATION. BytesNeededed Member in der NDIS_OID_REQUEST Struktur auf die erforderliche Mindestpuffergröße. |
NDIS_STATUS_INVALID_LENGTH |
Der Informationspuffer war zu kurz. NDIS legt die DATA fest. METHOD_INFORMATION. BytesNeededed Member in der NDIS_OID_REQUEST Struktur auf die erforderliche Mindestpuffergröße. |
NDIS_STATUS_FAILURE |
Fehler bei der Anforderung aus anderen Gründen. |
Anforderungen
Version |
Unterstützt in NDIS 6.30 und höher. |
Kopfball |
Ntddndis.h (include Ndis.h) |