Função D3DKMTMapGpuVirtualAddress (d3dkmthk.h)
D3DKMTMapGpuVirtualAddress mapeia um intervalo de endereços virtuais de GPU para um intervalo de alocação específico ou o coloca no estado Inválido ou Zero.
Sintaxe
NTSTATUS D3DKMTMapGpuVirtualAddress(
D3DDDI_MAPGPUVIRTUALADDRESS *unnamedParam1
);
Parâmetros
unnamedParam1
[in/out] pData é um ponteiro para uma estrutura D3DDDI_MAPGPUVIRTUALADDRESS que descreve a operação.
Valor de retorno
| Código de retorno | Descrição |
|---|---|
| STATUS_SUCCESS | O contexto do dispositivo foi criado com êxito. |
| STATUS_INVALID_PARAMETER | Os parâmetros foram validados e determinados como incorretos. |
Essa função também pode retornar outros valores de NTSTATUS.
Observações
O driver pode especificar um VA (endereço virtual de GPU) base para mapear ou permitir que o gerenciador de memória de vídeo escolha automaticamente um. Ao especificar um valor BaseAddress não NULL, todo o intervalo de baseAddress a BaseAddress+Size deve estar em um estado liberado ou pertencer a um intervalo va que foi obtido chamando D3DKMTMapGpuVirtualAddress ou DxgkCbReserveGpuVirtualAddressRange. Quando Protection.Zero ou Protection.NoAccess for especificado, o intervalo va não poderá pertencer a um intervalo obtido chamando MapGpuVirtualAddressCb.
O driver pode especificar se o mapeamento deve permitir privilégios de gravação e execução, além de privilégios de leitura, que sempre existem por padrão.
Na configuração do LDA (adaptador de exibição vinculado), a fila de paginação define uma GPU física cujas tabelas de página são modificadas e o identificador de alocação (se não NULL) define para onde as entradas da tabela de página estão apontando. A alocação pode ser residente em qualquer segmento de memória de GPU física.
O intervalo de VA da GPU, que é alocado pela API, é liberado quando a alocação (a VA da GPU é mapeada para) é destruída. O intervalo va também pode ser liberado chamando D3DKMTFreeGpuVirtualAddress, mas isso precisa ser sincronizado com a destruição de alocação, se necessário.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows 10 |
| servidor com suporte mínimo | Windows Server 2016 |
| da Plataforma de Destino | Universal |
| cabeçalho | d3dkmthk.h (inclua D3dkmthk.h) |
| biblioteca | Gdi32.lib |
| de DLL | Gdi32.dll |