SET_VIRTUAL_DEVICE_DATA Rückruffunktion (wdm.h)

Die SetVirtualFunctionData-Routine schreibt Daten in den PCI Express -Konfigurationsraum (PCIe) einer virtuellen Funktion (VF) auf einem Gerät, das die SR-IOV-Schnittstelle (Single Root E/O Virtualization) unterstützt.

Syntax

SET_VIRTUAL_DEVICE_DATA SetVirtualDeviceData;

ULONG SetVirtualDeviceData(
  [in, out] PVOID Context,
  [in]      USHORT VirtualFunction,
  [in]      PVOID Buffer,
  [in]      ULONG Offset,
  [in]      ULONG Length
)
{...}

Parameter

[in, out] Context

Ein Zeiger auf schnittstellenspezifische Kontextinformationen. Der Aufrufer übergibt den Wert, der als Kontextelement der PCI_VIRTUALIZATION_INTERFACE-Struktur für die Schnittstelle übergeben wird.

[in] VirtualFunction

Ein nullbasierter Wert, der die VF auf dem Gerät angibt, aus dem Daten geschrieben werden sollen.

[in] Buffer

Ein Zeiger auf den Puffer, der die Konfigurationsinformationen enthält, die in den PCIe-Konfigurationsraum des VF geschrieben werden sollen.

[in] Offset

Der Offset in die PCIe-Konfigurationsraumdaten des VF. Dieses Element gibt an, wo dieser Schreibvorgang beginnt.

[in] Length

Die Länge der zu schreibenden Daten in Bytes.

Rückgabewert

Die *SetVirtualFunctionData-Routine gibt die Länge der PCIe-Konfigurationsdaten in Bytes zurück, die nach einem erfolgreichen Schreibvorgang geschrieben wurden. Wenn der Schreibvorgang nicht erfolgreich ist, gibt die Routine null zurück.

Hinweise

Die *SetVirtualFunctionData-Routine ähnelt der SetBusData-Routine , mit der Ausnahme, dass sie PCIe-Konfigurationsdaten in eine VF anstatt in die physische Funktion (PF) eines Geräts schreibt.

Die *SetVirtualFunctionData-Routine wird von der GUID_PCI_VIRTUALIZATION_INTERFACE-Schnittstelle bereitgestellt. Die SetBusData-Routine wird von der GUID_BUS_INTERFACE_STANDARD-Schnittstelle bereitgestellt.

Der Virtualisierungsstapel ruft *SetVirtualFunctionData auf, wenn ein Treiber, der im Gastbetriebssystem ausgeführt wird, die SetBusData-Routine aufruft.

Anforderungen

Weitere Informationen

SetBusData

PCI_VIRTUALIZATION_INTERFACE