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:

• OID-Methodenanforderungen von OID_NIC_SWITCH_ALLOCATE_VF.

• OID-Set-Anforderungen von OID_NIC_SWITCH_VF_PARAMETERS.