DXGKDDI_CALIBRATEGPUCLOCK função de retorno de chamada (d3dkmddi.h)
Chamado pelo subsistema de kernel de elementos gráficos do Microsoft DirectX para calibrar os carimbos de data/hora de GPU no buffer de histórico de DXGK_HISTORY_BUFFER com a hora do relógio da CPU.
Sintaxe
DXGKDDI_CALIBRATEGPUCLOCK DxgkddiCalibrategpuclock;
NTSTATUS DxgkddiCalibrategpuclock(
IN_CONST_HANDLE hAdapter,
IN UINT32 NodeOrdinal,
IN UINT32 EngineOrdinal,
OUT_PDXGKARG_CALIBRATEGPUCLOCK pClockCalibration
)
{...}
Parâmetros
hAdapter
Um identificador para o objeto do adaptador para a GPU para a qual as informações de calibragem de tempo devem ser obtidas.
O driver de miniporto de exibição forneceu anteriormente esse identificador para o subsistema de kernel de elementos gráficos DirectX na função MiniportDeviceContext da função DxgkDdiAddDevice.
NodeOrdinal
Um índice de um nó para o qual as informações de calibragem de tempo serão obtidas. Esse nó está dentro do adaptador físico definido pelo parâmetro hAdapter.
EngineOrdinal
O índice baseado em zero do mecanismo, dentro do nó que especifica NodeOrdinal, para o qual as informações de calibragem de tempo serão obtidas. Para adaptadores gráficos que não fazem parte de um link em uma configuração LDA (adaptador de exibição) vinculada, você sempre deve definir EngineOrdinal como 0.
pClockCalibration
Um ponteiro para uma estrutura DXGKARG_CALIBRATEGPUCLOCK que fornece informações de contador de relógio da GPU e da CPU.
Valor de retorno
Retorna STATUS_SUCCESS se tiver êxito; caso contrário, ele retorna um dos códigos de erro definidos em Ntstatus.h.
Observações
O subsistema de kernel gráfico DirectX usa as informações retornadas no parâmetro pClockCalibration para estimar o descompasso entre os relógios de GPU e CPU.
Para minimizar as imprecisões de calibragem, o driver deve calcular os valores para o gpuClockCounter e CpuClockCounter membros da estrutura DXGKARG_CALIBRATEGPUCLOCK o mais quase simultaneamente possível.
O subsistema de kernel de elementos gráficos DirectX chama essa função com frequência suficiente, normalmente pelo menos uma vez a cada 30ms, para minimizar o descompasso acumulado entre os relógios de GPU e CPU.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows 8.1, WDDM 1.3 |
| servidor com suporte mínimo | Windows Server 2012 R2 |
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | d3dkmddi.h |
| IRQL | DISPATCH_LEVEL |