estrutura D3DKMT_PRESENT_STATS (d3dkmthk.h)
A estrutura D3DKMT_PRESENT_STATS descreve o status atual de um dispositivo de renderização.
Sintaxe
typedef struct _D3DKMT_PRESENT_STATS {
[out] UINT PresentCount;
[out] UINT PresentRefreshCount;
[out] UINT SyncRefreshCount;
[out] D3DKMT_ALIGN64 LARGE_INTEGER SyncQPCTime;
[out] D3DKMT_ALIGN64 LARGE_INTEGER SyncGPUTime;
} D3DKMT_PRESENT_STATS;
Membros
[out] PresentCount
Um valor UINT que indica o número de vezes que o ICD (driver de cliente) instalável do OpenGL chamou a função D3DKMTPresent em um dispositivo de renderização ou cadeia de troca. Depois que o valor máximo é atingido, PresentCount começa em zero. Quando um novo dispositivo de renderização é criado, PresentCount é inicializado como zero. O sistema operacional mantém um contador atual para cada cadeia de troca que é criada.
[out] PresentRefreshCount
Um valor UINT que indica o número de vezes que o controlador de exibição gera um novo quadro de vídeo, que ocorre no início de cada período de retração vertical. O sistema operacional mantém um contador de atualização atual para cada saída do controlador de exibição de vídeo no sistema operacional. PresentRefreshCount é inicializado para um valor não especificado.
[out] SyncRefreshCount
Um valor UINT que indica o número da captura mais recente das informações de tempo nos membros SyncQPCTime e SyncGPUTime.
[out] SyncQPCTime
A hora da CPU (unidade de processamento do computador) em que o quadro de vídeo atual foi gerado (ou seja, a hora da CPU em que o rastreamento vertical foi iniciado).
[out] SyncGPUTime
A hora da GPU (unidade de processamento gráfico) em que o quadro de vídeo atual foi gerado (ou seja, a hora da GPU em que o rastreamento vertical foi iniciado).
Observações
Quando uma operação atual é desativada, o sistema operacional mantém uma correspondência (mapeamento) entre o valor em PresentCount e o valor em PresentRefreshCount; ou seja, quando o sistema operacional conclui uma operação atual como um quadro de vídeo verificado, o valor em PresentRefreshCount com o qual a operação atual foi concluída está associado ao valor em PresentCount da operação atual desativada.
O sistema operacional mantém informações de tempo em um dispositivo de renderização e associa as informações de tempo a uma saída de exibição. Quando a GPU pode manter o tempo de GPU (SyncGPUTime), o tempo de GPU opera em uma frequência específica do dispositivo. Para permitir que os aplicativos relacionem o tempo de GPU a outras operações no sistema, o sistema operacional mantém uma correspondência entre o tempo de GPU e o tempo de CPU (SyncQPCTime). Quando a GPU não pode manter esse tempo de GPU, o sistema operacional mantém apenas o tempo de CPU e o tempo de GPU associado é sempre zero.
As estatísticas presentes não podem funcionar para dispositivos em modo de janela. Para o modo com janelas, cada membro da estrutura é definido como zero.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows Vista |
| cabeçalho | d3dkmthk.h (inclua D3dkmthk.h) |