Função D3DKMTRegisterVailProcess (d3dkmthk.h)

A função D3DKMTRegisterVailProcess registra o processo atual como aquele que pode compartilhar alocações de GPU entre uma VM (máquina virtual) convidada e o host.

Sintaxe

NTSTATUS D3DKMTRegisterVailProcess(
  GUID *unnamedParam1
);

Parâmetros

unnamedParam1

[in] VirtualMachineGuid, que é um ponteiro para o GUID associado a uma VM em execução. A VM deve ter pelo menos uma GPU virtual atribuída.

Valor de retorno

D3DKMTRegisterVailProcess retorna um código NTSTATUS, como um dos seguintes valores:

Código de retorno	Descrição
STATUS_SUCCESS	O registro do processo foi bem-sucedido.
STATUS_ACCESS_DENIED	O processo não tem privilégios suficientes para chamar essa API. Observe que outros códigos de status podem ser retornados nesse caso.
STATUS_INVALID_PARAMETER	O valor passado em VirtualMachineGuid não é válido.
STATUS_GRAPHICS_VAIL_STATE_CHANGED	A VM não tem uma GPU virtual atribuída.
STATUS_INVALID_DISPOSITION	O processo não tem o contexto gráfico criado.
STATUS_NOT_FOUND	Uma VM com o GUID fornecido não foi encontrada.

Outros códigos de status também podem ser retornados.

Observações

O processo de chamada deve ter os mesmos privilégios que o processo de cliente rdp (Área de Trabalho Remota) que foi criado para a instância de VM especificada pelo parâmetro VirtualMachineGuid.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 11, versão 22H2
da Plataforma de Destino	Universal
cabeçalho	d3dkmthk.h (inclua d3dkmthk.h)
biblioteca	gdi32.lib
de DLL	gdi32.dll