SET_VIRTUAL_DEVICE_DATA funzione di callback (wdm.h)

Articolo
08/08/2023

La routine SetVirtualFunctionData scrive i dati nello spazio di configurazione PCI Express (PCIe) di una funzione virtuale (VF) in un dispositivo che supporta l'interfaccia di virtualizzazione I/O radice singola (SR-IOV).

Sintassi

SET_VIRTUAL_DEVICE_DATA SetVirtualDeviceData;

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

Parametri

[in, out] Context

Puntatore a informazioni di contesto specifiche dell'interfaccia. Il chiamante passa il valore passato come membro Contesto della struttura di PCI_VIRTUALIZATION_INTERFACE per l'interfaccia.

[in] VirtualFunction

Valore in base zero che specifica il VF nel dispositivo da cui scrivere i dati.

[in] Buffer

Puntatore al buffer che contiene le informazioni di configurazione da scrivere nello spazio di configurazione PCIe dell'VF.

[in] Offset

Offset nei dati dello spazio di configurazione PCIe del VF. Questo membro specifica dove inizia questa operazione di scrittura.

[in] Length

Lunghezza, in byte, dei dati da scrivere.

Valore restituito

La routine *SetVirtualFunctionData restituisce la lunghezza, in byte, dei dati di configurazione PCIe scritti dopo un'operazione di scrittura riuscita. Se l'operazione di scrittura ha esito negativo, la routine restituisce zero.

Commenti

La routine *SetVirtualFunctionData è simile alla routine SetBusData , ad eccezione del fatto che scrive i dati di configurazione PCIe in una funzione fisica di un dispositivo anziché in una funzione fisica di un dispositivo.

La routine *SetVirtualFunctionData viene fornita dall'interfaccia GUID_PCI_VIRTUALIZATION_INTERFACE . La routine SetBusData viene fornita dall'interfaccia GUID_BUS_INTERFACE_STANDARD .

Lo stack di virtualizzazione chiama *SetVirtualFunctionData quando un driver in esecuzione nel sistema operativo guest chiama la routine SetBusData .

Requisiti

Requisito	Valore
Client minimo supportato	Supportato in Windows Server 2012 e versioni successive di Windows.
Piattaforma di destinazione	Desktop
Intestazione	wdm.h (include Wdm.h)
IRQL	IRQL <= APC_LEVEL

Vedi anche

SetBusData

PCI_VIRTUALIZATION_INTERFACE

Condividi tramite