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 da 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 kernel de elementos gráficos DirectX no parâmetro de saída 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ó especificado por 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.
Retornar valor
Retorna STATUS_SUCCESS se for bem-sucedido; caso contrário, retornará um dos códigos de erro definidos em Ntstatus.h.
Comentários
O subsistema de kernel de elementos gráficos 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 os membros GpuClockCounter e CpuClockCounter 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 |
|---|---|
| Cliente mínimo com suporte | Windows 8.1,WDDM 1.3 |
| Servidor mínimo com suporte | Windows Server 2012 R2 |
| Plataforma de Destino | Área de Trabalho |
| Cabeçalho | d3dkmddi.h |
| IRQL | DISPATCH_LEVEL |