SET_VIRTUAL_DEVICE_DATA función de devolución de llamada (wdm.h)
El SetVirtualFunctionData rutina escribe datos en el espacio de configuración de 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 el miembro Context de la estructura PCI_VIRTUALIZATION_INTERFACE de 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 que se escribieron después de una operación de escritura correcta. Si la operación de escritura no se realiza correctamente, la rutina devuelve cero.
Observaciones
La rutina *SetVirtualFunctionData es similar a la rutina de SetBusData, salvo que escribe datos de configuración de PCIe en un VF en lugar de en la función física de un dispositivo (PF).
La rutina *SetVirtualFunctionData proporciona la interfaz GUID_PCI_VIRTUALIZATION_INTERFACE. La rutina SetBusData se proporciona mediante la interfaz GUID_BUS_INTERFACE_STANDARD.
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 | Valor |
|---|---|
| cliente mínimo admitido | Compatible con Windows Server 2012 y versiones posteriores de Windows. |
| de la plataforma de destino de | Escritorio |
| encabezado de | wdm.h (incluya Wdm.h) |
| irQL | IRQL <= APC_LEVEL |