PFND3DDDI_RESERVEGPUVIRTUALADDRESSCB função de retorno de chamada (d3dumddi.h)

Artigo
07/20/2024

O runtime do D3D pfnReserveGPUVirtualAddressCb reserva um intervalo de endereços no espaço de endereço virtual gpu do processo atual. O intervalo de endereços é reservado apenas, não há memória real por trás dele.

Sintaxe

PFND3DDDI_RESERVEGPUVIRTUALADDRESSCB Pfnd3dddiReservegpuvirtualaddresscb;

HRESULT Pfnd3dddiReservegpuvirtualaddresscb(
  HANDLE hDevice,
  D3DDDI_RESERVEGPUVIRTUALADDRESS *unnamedParam2
)
{...}

Parâmetros

hDevice

[in] Um identificador para o dispositivo de exibição.

unnamedParam2

[entrada/saída] Ponteiro para uma estrutura D3DDDI_RESERVEGPUVIRTUALADDRESS que descreve a operação a ser executada.

Valor de retorno

Se essa função de retorno de chamada for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Observações

O UMD (driver de modo de usuário) pode escolher o endereço virtual de GPU base a ser usado para a reserva especificando um valor não NULL para BaseAddress. O gerenciador de memória de vídeo (VidMm) usará o intervalo especificado se estiver disponível. Se o intervalo se cruzar com um intervalo existente, a operação falhará. O UMD pode passar um BaseAddress NULL para permitir que VidMm escolher um endereço base.

Quando a UMD opta por permitir que VidMm escolha um endereço base para o intervalo de endereços virtuais de GPU, o UMD pode optar por restringir o intervalo que VidMm deve considerar especificando valores não NULL para MinimumAddress e MaximumAddress. VidMm garantirá que o intervalo de endereços virtuais de GPU alocado esteja totalmente contido no intervalo. A UMD pode especificar apenas um MinimumAddress, em que MaximumAddress é considerado o fim do espaço de endereço. Ou a UMD pode especificar apenas umMaximumAddress, em que MinimumAddress é considerado 0.

Quando a UMD chama pfnReserveGpuVertualAddrsesCb com hAdapter definido como 0, o runtime D3D definirá hAdapter para o D3DKMT_HANDLE do kernel antes de chamar a interface de kernel D3DKMTReserveGpuVirtualAddress.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 10
servidor com suporte mínimo	Windows Server 2016
da Plataforma de Destino	Área de trabalho
cabeçalho	d3dumddi.h (inclua D3dumddi.h)

Consulte também

D3DDDI_RESERVEGPUVIRTUALADDRESS

Compartilhar via