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
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Unterstützt in Windows Server 2012 und höheren Versionen von Windows. |
| Zielplattform | Desktop |
| Kopfzeile | wdm.h (einschließen von Wdm.h) |
| IRQL | IRQL <= APC_LEVEL |