WHvWriteVpciDeviceRegister

Grava um espaço de configuração ou registro MMIO de um dispositivo VPCI (PCI virtual).

Sintaxe

typedef enum WHV_VPCI_DEVICE_REGISTER_SPACE
{
    WHvVpciConfigSpace = -1,
    WHvVpciBar0 = 0,
    WHvVpciBar1 = 1,
    WHvVpciBar2 = 2,
    WHvVpciBar3 = 3,
    WHvVpciBar4 = 4,
    WHvVpciBar5 = 5
} WHV_VPCI_DEVICE_REGISTER_SPACE;

typedef struct WHV_VPCI_DEVICE_REGISTER
{
    WHV_VPCI_DEVICE_REGISTER_SPACE Location;
    UINT32 SizeInBytes;
    UINT64 OffsetInBytes;
} WHV_VPCI_DEVICE_REGISTER;

HRESULT
WINAPI
WHvWriteVpciDeviceRegister(
    _In_ WHV_PARTITION_HANDLE Partition,
    _In_ UINT64 LogicalDeviceId,
    _In_ const WHV_VPCI_DEVICE_REGISTER* Register,
    _In_reads_bytes_(Register->SizeInBytes) const VOID* Data
    );

Parameters

Partition

Manipule para a partição que possui o dispositivo VPCI.

LogicalDeviceId

Especifica o identificador de dispositivo lógico do dispositivo VPCI.

Register

Especifica o registro a ser gravado, como uma WHV_VPCI_DEVICE_REGISTER estrutura que identifica o espaço, o deslocamento e o tamanho do registro.

Data

Especifica os dados a serem gravados no registro. O buffer deve ser pelo menos Register->SizeInBytes bytes.

Valor de retorno

Se a função for bem-sucedida, o valor retornado será S_OK.

Remarks

A WHvWriteVpciDeviceRegister função grava um registro no espaço de configuração ou no espaço MMIO da função física ou virtual PCIe associada a um dispositivo VPCI. Para o espaço de configuração, o acesso a determinados registros pode ser filtrado pela pilha PCI virtual subjacente para garantir a atribuição de VM segura de funções PCIe. Para o espaço MMIO, essa função pode gravar registros que não foram mapeados diretamente no espaço de endereço do chamador porque a pilha de PCI virtual subjacente deve impor mitigações para esses registros.

Requisitos

Consulte também

• WHvReadVpciDeviceRegister
• WHvMapVpciDeviceMmioRanges
• Tipos de dados de PCI virtual
• definições de API da Plataforma do Hipervisor Windows