SET_VIRTUAL_DEVICE_DATA Rückruffunktion (wdm.h)

Artikel
02/07/2025

Die SetVirtualFunctionData Routine schreibt Daten in den PCI Express(PCIe)-Konfigurationsraum einer virtuellen Funktion (VF) auf einem Gerät, das die einzelne I/O-Virtualisierungsschnittstelle (SR-IOV) 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 Context Member der PCI_VIRTUALIZATION_INTERFACE Struktur für die Schnittstelle übergeben wird.

[in] VirtualFunction

Ein nullbasierter Wert, der den 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 den 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 Routine *SetVirtualFunctionData 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.

Bemerkungen

Die Routine *SetVirtualFunctionData ähnelt der SetBusData- Routine, mit der Ausnahme, dass pcIe-Konfigurationsdaten anstelle der physischen Funktion eines Geräts (PF) in einen VF geschrieben werden.

DieSetVirtualFunctionData 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

Anforderung	Wert
mindestens unterstützte Client-	Unterstützt in Windows Server 2012 und höheren Versionen von Windows.
Zielplattform-	Desktop
Header-	wdm.h (include Wdm.h)
IRQL-	IRQL-<= APC_LEVEL

Siehe auch

SetBusData-

PCI_VIRTUALIZATION_INTERFACE

Freigeben über