DXGKARG_FORMATHISTORYBUFFER estrutura (d3dkmddi.h)
Contém informações para o driver de miniporto de exibição para formatar um buffer de histórico.
Sintaxe
typedef struct _DXGKARG_FORMATHISTORYBUFFER {
DXGK_HISTORY_BUFFER *pHistoryBuffer;
UINT32 HistoryBufferSize;
PVOID pFormattedBuffer;
UINT32 FormattedBufferSize;
UINT32 NumTimestamps;
DXGKARG_HISTORYBUFFERPRECISION Precision;
UINT32 Offset;
} DXGKARG_FORMATHISTORYBUFFER;
Membros
pHistoryBuffer
Um ponteiro para o buffer de histórico de DXGK_HISTORY_BUFFER não formatado que foi preenchido pela GPU.
HistoryBufferSize
O tamanho, em bytes, do buffer apontado por pHistoryBuffer.
pFormattedBuffer
Um ponteiro para um segmento de memória do sistema não paged que o driver usa para armazenar informações de carimbo de data/hora que ele deriva do buffer de histórico não formatado fornecido.
O buffer apontado por pFormattedBuffer deve ser gerenciado como uma grande matriz de carimbos de tempo de precisão especificados por Precision. O buffer não deve conter nenhuma informação de cabeçalho que já exista no buffer de histórico original.
FormattedBufferSize
O tamanho, em bytes, do buffer apontado por pFormattedBuffer. O driver deve garantir que ele não escreva dados além desse tamanho de buffer.
NumTimestamps
O número de carimbos de data/hora. Após a conclusão de uma chamada para a função DxgkDdiFormatHistoryBuffer, o driver deve definir esse valor como o número de carimbos de data/hora gravados no buffer formatado apontado por pFormattedBuffer.
Observe que o número de carimbos de data/hora que estarão no buffer de saída formatado não será conhecido até que o driver conclua o buffer formatado apontado por pFormattedBuffer.
Precision
Uma estrutura DXGKARG_HISTORYBUFFERPRECISION que o driver preenche com informações sobre a precisão dos carimbos de data/hora que serão registrados na instalação ETW (Rastreamento de Eventos para Windows).
O valor do DXGKARG_HISTORYBUFFERPRECISION.membro do PrecisionBits não pode ser zero.
Offset
Na entrada de uma chamada para a função DxgkDdiFormatHistoryBuffer, o valor desse membro é o deslocamento para o primeiro carimbo de data/hora em que a formatação deve ser iniciada. Ao concluir a chamada de função, o driver deverá definir o valor como zero se tiver formatado com êxito todos os carimbos de data/hora no buffer de histórico.
Se não for zero, o driver não poderá formatar todos os carimbos de data/hora no buffer de histórico sem preencher o buffer formatado. Nesse caso, o valor representa o deslocamento do qual deve ser continuado na próxima chamada de função.
Observações
O driver deve obter entradas de carimbo de data/hora e o número de carimbos de data/hora utilizáveis do cabeçalho do buffer de histórico fornecido. Quaisquer dados adicionais de que o driver precisa para cálculos devem ser armazenados em dados privados.
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) |