SET_VIRTUAL_DEVICE_DATA función de devolución de llamada (wdm.h)
La rutina SetVirtualFunctionData escribe datos en el espacio de configuración PCI Express (PCIe) de una función virtual (VF) en un dispositivo que admite la interfaz de virtualización de E/S raíz única (SR-IOV).
Sintaxis
SET_VIRTUAL_DEVICE_DATA SetVirtualDeviceData;
ULONG SetVirtualDeviceData(
[in, out] PVOID Context,
[in] USHORT VirtualFunction,
[in] PVOID Buffer,
[in] ULONG Offset,
[in] ULONG Length
)
{...}
Parámetros
[in, out] Context
Puntero a información de contexto específica de la interfaz. El autor de la llamada pasa el valor que se pasa como miembro Context de la estructura PCI_VIRTUALIZATION_INTERFACE para la interfaz.
[in] VirtualFunction
Valor de base cero que especifica el VF en el dispositivo desde el que se van a escribir los datos.
[in] Buffer
Puntero al búfer que contiene la información de configuración que se va a escribir en el espacio de configuración PCIe del VF.
[in] Offset
Desplazamiento en los datos del espacio de configuración PCIe del VF. Este miembro especifica dónde comienza esta operación de escritura.
[in] Length
Longitud, en bytes, de los datos que se van a escribir.
Valor devuelto
La rutina *SetVirtualFunctionData devuelve la longitud, en bytes, de los datos de configuración pcIe escritos después de una operación de escritura correcta. Si la operación de escritura no se realiza correctamente, la rutina devuelve cero.
Comentarios
La rutina *SetVirtualFunctionData es similar a la rutina SetBusData , salvo que escribe datos de configuración de PCIe en una VF en lugar de en la función física de un dispositivo (PF).
La interfaz GUID_PCI_VIRTUALIZATION_INTERFACE proporciona la rutina *SetVirtualFunctionData. La interfaz GUID_BUS_INTERFACE_STANDARD proporciona la rutina SetBusData.
La pila de virtualización llama a *SetVirtualFunctionData cuando un controlador que se ejecuta en el sistema operativo invitado llama a la rutina SetBusData .
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Compatible con Windows Server 2012 y versiones posteriores de Windows. |
| Plataforma de destino | Escritorio |
| Encabezado | wdm.h (incluya Wdm.h) |
| IRQL | IRQL <= APC_LEVEL |