Compartilhar via


estrutura DXGK_HISTORY_BUFFER_HEADER (d3dkmddi.h)

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 valor que deve ser usado em uma chamada para a função de pfnRenderCb.

O driver de miniporto 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 DMA 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 na instalação ETW (Rastreamento de Eventos para Windows).

PrivateDataSize

O tamanho, em bytes, de dados privados opcionais armazenados pelo driver. O driver pode usar esses dados para qualquer finalidade.

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

Observação Esse valor deve ser um múltiplo de 8 bytes para garantir que os dados do 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 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 fazer referência aos carimbos de data/hora.

Reserved

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

Observações

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 do 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
de cliente com suporte mínimo Windows 8.1, WDDM 1.3 e posterior
servidor com suporte mínimo Windows Server 2012 R2
cabeçalho d3dkmddi.h (inclua D3dkmddi.h)

Consulte também

D3DDDICB_RENDERFLAGS

DXGK_HISTORY_BUFFER

pfnRenderCb