Partilhar via


DXGKDDI_UPDATEMONITOREDVALUES função de retorno de chamada (d3dkmddi.h)

Dxgkrnl chamadas DxgkDdiUpdateMonitoredValues para instruir o KMD (driver de exibição no modo kernel) a atualizar um lote de valores monitorados.

Sintaxe

DXGKDDI_UPDATEMONITOREDVALUES DxgkddiUpdatemonitoredvalues;

NTSTATUS DxgkddiUpdatemonitoredvalues(
  IN_CONST_PDXGKARG_UPDATEMONITOREDVALUES pUpdateMonitoredValues
)
{...}

Parâmetros

pUpdateMonitoredValues

[in] Ponteiro para uma estrutura DXGKARG_UPDATEMONITOREDVALUES que contém os valores monitorados a serem atualizados.

Valor de retorno

DxgkDdiUpdateMonitoredValues retornará STATUS_SUCCESS se o KMD conseguir atualizar com êxito o lote de valores monitorados. Caso contrário, ele retornará um código de erro NTSTATUS apropriado.

Observações

DxgkDdiUpdateMonitoredValues é executado no nível de interrupção do dispositivo e, portanto, é sincronizado com a ISR (rotina de serviço de interrupção sinalizada por cerca monitorada).

A implementação DxgkDdiUpdateMonitoredValues de kmd deve garantir que o CurrentValue lido por qualquer núcleo de processador após o retorno da chamada ter sido gravado pelo processador de gerenciamento de contexto gpu depois de ter observado o novo MonitoredValue.

DxgkDdiUpdateMonitoredValues deve gravar os valores de UpdatedValueArray no local especificado por MonitoredValueGpuVa, respeitando o contrato de sincronização.

O sistema operacional garante apenas que o ponteiro MonitoredValueKernelCpuVa seja válido durante essa chamada DDI e não antes ou depois dela. Portanto, o KMD nunca deve armazenar esse ponteiro em cache para usá-lo em outro lugar.

Para obter mais informações sobre cercas de GPU nativas, consulte objetos de cerca de GPU nativa.

Requisitos

Requisito Valor
de cliente com suporte mínimo Windows 11, versão 24H2
cabeçalho d3dkmddi.h
IRQL PROFILE_LEVEL-1

Consulte também

DXGKARG_UPDATEMONITOREDVALUES