Abfragen der Parameter eines virtuellen Ports

Ein überlastender Treiber kann die Parameter für einen virtuellen Port (VPort) auf einem NIC-Switch eines Netzwerkadapters abrufen, der single root E/A Virtualization (SR-IOV) unterstützt. Der Treiber stellt eine OID-Methodenanforderung (Object Identifier) von OID_NIC_SWITCH_VPORT_PARAMETERS aus, um diese Parameter abzurufen.

Bevor der überlastende Treiber diese OID-Methodenanforderung ausgibt, muss er eine NDIS_NIC_SWITCH_VPORT_PARAMETERS-Struktur initialisieren. Der Treiber muss die Member dieser Struktur wie folgt festlegen:

• Das SwitchId-Element muss auf den Bezeichner des NIC-Switches festgelegt werden, für den Parameter zurückgegeben werden sollen.

  Hinweis Ab Windows Server 2012 unterstützt die SR-IOV-Schnittstelle nur einen NIC-Switch auf dem Netzwerkadapter. Dieser Switch wird als Standard-NIC-Switch bezeichnet. Das SwitchId-Element muss auf NDIS_DEFAULT_SWITCH_ID festgelegt werden.

• Das VPortId-Element muss auf den Bezeichner festgelegt werden, der dem VPort zugeordnet ist. Der überlastende Treiber ruft den VPort-Bezeichner über eine der folgenden Methoden ab:

  • Aus einer vorherigen OID-Methodenanforderung von OID_NIC_SWITCH_CREATE_VPORT.

  • Aus einer vorherigen OID-Methodenanforderung von OID_NIC_SWITCH_ENUM_VPORTS.

Nach erfolgreicher Rückgabe dieser OID-Methodenanforderung enthält das InformationBuffer-Element der NDIS_OID_REQUEST-Struktur einen Zeiger auf eine NDIS_NIC_SWITCH_VPORT_PARAMETERS Struktur. Diese Struktur enthält die Parameter für den angegebenen VPort.

NDIS verarbeitet die OID_NIC_SWITCH_VPORT_PARAMETERS-Anforderung für Miniporttreiber. NDIS gibt die Informationen aus einem internen Cache der Daten zurück, die von der Überprüfung der folgenden Quellen verwaltet werden:

• Anforderungen der OID-Methode von OID_NIC_SWITCH_CREATE_VPORT.

• OID-Anforderungen von OID_NIC_SWITCH_VPORT_PARAMETERS festlegen.