Compartilhar via

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

  • Artigo

Dxgkrnl chama DxgkDdiUpdateMonitoredValues para instruir o KMD (driver de exibição do 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.

Retornar valor

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

Comentários

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

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

Espera-se que DxgkDdiUpdateMonitoredValues grave os valores UpdatedValueArray no local especificado por MonitoredValueGpuVa enquanto respeita o contrato de sincronização.

O sistema operacional garante apenas que o ponteiro MonitoredValueKernelCpuVa seja válido durante a 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 nativos.

Requisitos

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

Confira também

DXGKARG_UPDATEMONITOREDVALUES