Freigeben über


Abfragen der Parameter einer virtuellen Funktion

Ein überlastender Treiber oder eine Benutzermodusanwendung kann die aktuellen Parameter für eine PCI Express (PCIe) Virtual Function (VF) auf einem Netzwerkadapter abrufen, der SR-IOV (Single Root I/O Virtualization) unterstützt. Der Treiber oder die Anwendung gibt eine OID-Methodenanforderung (Object Identifier) von OID_NIC_SWITCH_VF_PARAMETERS aus, um diese Parameter abzurufen.

Bevor der übergeordnete Treiber diese OID-Methodenanforderung ausgibt, muss er eine NDIS_NIC_SWITCH_VF_PARAMETERS-Struktur initialisieren. Der Treiber oder die Anwendung muss den VFId-Member auf den Bezeichner des VF festlegen, für den Parameter zurückgegeben werden sollen. Der VF-Bezeichner kann auf folgende Weise abgerufen werden:

  • 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.

NDIS verarbeitet die OID_NIC_SWITCH_VF_PARAMETERS Anforderung für Miniporttreiber. NDIS gibt die Informationen aus einem internen Cache der Daten zurück, die es bei der Überprüfung der folgenden Quellen verwaltet: