estrutura DXGK_HISTORY_BUFFER_HEADER (d3dkmddi.h)

  • Artigo

Especifica como os dados são armazenados em um buffer de histórico de DXGK_HISTORY_BUFFER .

Sintaxe

typedef struct _DXGK_HISTORY_BUFFER_HEADER {
  UINT32 RenderCbSequence;
  UINT32 NumTimestamps;
  UINT32 PrivateDataSize;
  UINT32 Reserved;
} DXGK_HISTORY_BUFFER_HEADER;

Membros

RenderCbSequence

O valor do D3DDDICB_RENDERFLAGS. Membro de valor que deve ser usado em uma chamada para a função pfnRenderCb .

O driver de miniporta de exibição deve calcular esse valor e inseri-lo em DXGK_HISTORY_BUFFER_HEADER antes de chamar pfnRenderCb.

NumTimestamps

O número de carimbos de data/hora que estarão no buffer de histórico quando o buffer de AMD concluir sua execução.

O driver deve incluir todos os carimbos de data/hora registrados, mesmo que o buffer precise ser formatado antes de ser registrado no recurso ETW (Rastreamento de Eventos para Windows).

PrivateDataSize

O tamanho, em bytes, de dados privados opcionais que o driver armazena. O driver pode usar esses dados para qualquer finalidade.

Se zero, o driver não precisará armazenar dados privados no buffer de histórico.

Nota Esse valor deve ser um múltiplo de 8 bytes para garantir que os dados de carimbo de data/hora estejam alinhados a um limite de 64 bits.
 
Se o buffer de histórico não precisar ser formatado quando o buffer de DMA concluir sua execução, quando o subsistema de kernel de gráficos DirectX gravar logs no ETW, ele usará PrivateDataSize como um deslocamento direto do cabeçalho para referenciar os carimbos de data/hora.

Reserved

Reservado para uso do sistema e deve ser definido como zero.

Comentários

Somente a parte do carimbo de data/hora do buffer de histórico, juntamente com o número de carimbos de data/hora, será registrada no ETW. Os dados de cabeçalho e os dados do driver privado não serão registrados no ETW como parte do buffer de carimbo de data/hora. No entanto, partes do cabeçalho serão registradas separadamente.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 8.1, WDDM 1.3 e posterior
Servidor mínimo com suporte Windows Server 2012 R2
Cabeçalho d3dkmddi.h (inclua D3dkmddi.h)

Confira também

D3DDDICB_RENDERFLAGS

DXGK_HISTORY_BUFFER

pfnRenderCb