SET_VIRTUAL_DEVICE_DATA função de retorno de chamada (wdm.h)
A rotina SetVirtualFunctionData grava dados no espaço de configuração PCI Express (PCIe) de uma VF (função virtual) em um dispositivo que dá suporte à interface de virtualização de E/S raiz única (SR-IOV).
Sintaxe
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
Um ponteiro para informações de contexto específicas da interface. O chamador passa o valor que é passado como o membro Context da estrutura PCI_VIRTUALIZATION_INTERFACE para a interface.
[in] VirtualFunction
Um valor baseado em zero que especifica o VF no dispositivo do qual os dados devem ser gravados.
[in] Buffer
Um ponteiro para o buffer que contém as informações de configuração a serem gravadas no espaço de configuração PCIe do VF.
[in] Offset
O deslocamento para os dados de espaço de configuração PCIe do VF. Este membro especifica onde esta operação de gravação começa.
[in] Length
O comprimento, em bytes, dos dados a serem gravados.
Retornar valor
A rotina *SetVirtualFunctionData retorna o comprimento, em bytes, dos dados de configuração do PCIe que foram gravados após uma operação de gravação bem-sucedida. Se a operação de gravação não for bem-sucedida, a rotina retornará zero.
Comentários
A rotina *SetVirtualFunctionData é semelhante à rotina SetBusData , exceto por gravar dados de configuração pcie em um VF em vez de na função física (PF) de um dispositivo.
A rotina *SetVirtualFunctionData é fornecida pela interface GUID_PCI_VIRTUALIZATION_INTERFACE . A rotina SetBusData é fornecida pela interface GUID_BUS_INTERFACE_STANDARD .
A pilha de virtualização chama *SetVirtualFunctionData quando um driver em execução no sistema operacional convidado chama a rotina SetBusData .
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Com suporte em Windows Server 2012 e versões posteriores do Windows. |
| Plataforma de Destino | Área de Trabalho |
| Cabeçalho | wdm.h (inclua Wdm.h) |
| IRQL | IRQL <= APC_LEVEL |