GET_VIRTUAL_DEVICE_DATA función de devolución de llamada (wdm.h)
La rutina GetVirtualFunctionData lee datos del 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
GET_VIRTUAL_DEVICE_DATA GetVirtualDeviceData;
ULONG GetVirtualDeviceData(
[in, out] PVOID Context,
[in] USHORT VirtualFunction,
[out] 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 de la interfaz.
[in] VirtualFunction
Valor de base cero que especifica el VF en el dispositivo desde el que se van a leer los datos.
[out] Buffer
Puntero al búfer que contiene la información de configuración leída desde 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 lectura.
[in] Length
Longitud, en bytes, de los datos que se van a leer.
Valor devuelto
La rutina GetVirtualFunctionData devuelve la longitud, en bytes, de los datos de configuración pcIe que se leyeron después de una operación de lectura correcta. Si la operación de lectura no se realiza correctamente, la rutina devuelve cero.
Comentarios
La rutina GetVirtualFunctionData es similar a la rutina GetBusData , salvo que lee los datos de configuración de PCIe de un VF en lugar de desde la función física (PF) de un dispositivo.
La interfaz GUID_PCI_VIRTUALIZATION_INTERFACE proporciona la rutina GetVirtualFunctionData. La interfaz GUID_BUS_INTERFACE_STANDARD proporciona la rutina GetBusData.
La pila de virtualización llama a GetVirtualFunctionData cuando un controlador que se ejecuta en el sistema operativo invitado llama a la rutina GetBusData .
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Se admite en Windows Server 2012 y versiones posteriores de Windows. |
| Plataforma de destino | Escritorio |
| Encabezado | wdm.h (incluya Wdm.h) |
| IRQL | IRQL <= APC_LEVEL |