estrutura DXGKARGCB_MAPFRAMEBUFFERPOINTER (d3dkmddi.h)

A estrutura DXGKARGCB_MAPFRAMEBUFFERPOINTER contém argumentos usados pela função de retorno de chamada DXGKCB_MAPFRAMEBUFFERPOINTER para mapear um ponteiro de buffer de quadro.

Sintaxe

typedef struct _DXGKARGCB_MAPFRAMEBUFFERPOINTER {
  [in]     UINT   PhysicalAdapterIndex;
  [in]     SIZE_T Size;
  [in/out] SIZE_T Offset;
  [out]    PVOID  pBaseAddress;
} DXGKARGCB_MAPFRAMEBUFFERPOINTER;

Membros

[in] PhysicalAdapterIndex

O índice do adaptador físico.

[in] Size

O tamanho, em bytes, da sub-região mapeada do objeto de seção. O tamanho deve ser um múltiplo de PAGE_SIZE.

[in/out] Offset

Na entrada, esse é o deslocamento, em bytes, para a sub-região mapeada do objeto de seção. O deslocamento deve ser um múltiplo de PAGE_SIZE. Na saída, esse é o deslocamento do endereço base de saída para o qual o driver deve copiar os dados.

[out] pBaseAddress

Um ponteiro de endereço base acessível da CPU para a sub-região mapeada do objeto de seção. O driver deve adicionar o valor deslocamento de saída ao endereço base para obter o endereço de destino de qualquer operação de cópia (pDestinationAddress = pBaseAddress + Offset).

Comentários

Se a fixação de todo o objeto de seção do buffer de quadro falhar, o driver deverá tentar garantir o progresso do encaminhamento executando a transferência em partes menores. Isso é feito alocando um pequeno MDL ou parte da memória durante o tempo de inicialização que pode ser usado para transferir o conteúdo do hardware e, em seguida, chamando DXGKCB_MAPFRAMEBUFFERPOINTER para obter um ponteiro para uma sub-região do objeto de seção.

O driver é responsável por copiar os dados do buffer pré-alocado para a sub-região mapeada. O inverso também é verdadeiro ao restaurar o conteúdo do buffer de quadros.

Consulte Isolamento de GPU baseado em IOMMU para obter mais informações.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 10, versão 1803 (WDDM 2.4)
Cabeçalho	d3dkmddi.h

Confira também

DXGKCB_MAPFRAMEBUFFERPOINTER