EVT_IDD_CX_ADAPTER_COMMIT_MODES2 função de retorno de chamada (iddcx.h)

Artigo
02/07/2025

O sistema operacional chama EVT_IDD_CX_ADAPTER_COMMIT_MODES2 para informar o driver de uma alteração de modo para monitores no adaptador.

Sintaxe

EVT_IDD_CX_ADAPTER_COMMIT_MODES2 EvtIddCxAdapterCommitModes2;

NTSTATUS EvtIddCxAdapterCommitModes2(
  IDDCX_ADAPTER AdapterObject,
  const IDARG_IN_COMMITMODES2 *pInArgs
)
{...}

Parâmetros

AdapterObject

[in] O objeto do adaptador gerado pelo sistema operacional do adaptador que está sendo consultado. Esse identificador de objeto IDDCX_ADAPTER foi retornado em uma chamada anterior para IddCxAdapterInitAsync.

pInArgs

[in] Ponteiro para uma estrutura de IDARG_IN_COMMITMODES2 que contém argumentos usados por EVT_IDD_CX_ADAPTER_COMMIT_MODES2.

Valor de retorno

EVT_IDD_CX_ADAPTER_COMMIT_MODES2 retorna um valor de NTSTATUS. Se a operação for bem-sucedida, ela retornará STATUS_SUCCESS ou outro valor de status para o qual NT_SUCCESS(status) é igual a TRUE. Caso contrário, ele retornará um código de erro NTSTATUS apropriado.

Observações

Quando os modos são confirmados para monitores, os drivers IddCx versão 1.10 que dão suporte a HDR ou WCG são chamados por meio dessa função e orientados ao espaço de cores e bits por componente a serem usados na conexão do monitor físico. Esses valores são baseados nos parâmetros de modo e recursos de destino relatados anteriormente pelo driver. Relatar suporte ao adaptador para FP16 mas não expor essa função é um erro.

O espaço de cor especificado em um modo confirmado não especifica o formato de superfície usado para cada superfície em uma cadeia de troca. A superfície fornecida em IDDCX_METADATA2 ainda deve ser consultada.

O sistema operacional sempre fornece o IDDCX_PATH2 para cada monitor conectado, mesmo que esse monitor não esteja ativo, e indica quais caminhos foram alterados. Se um caminho estiver marcado como inativo, todo o pipeline de exibição desse caminho será desligado e nenhum sinal será enviado para o monitor.

Quando um novo caminho é confirmado, o driver deve programar o pipeline de exibição para exibir uma imagem preta até que o primeiro quadro esteja pronto para ser exibido. Para fazer isso, a visibilidade do WDDM deve estar desativada até que o primeiro quadro esteja pronto para ser exibido e, em seguida, a visibilidade deve ser ativada.

Para obter mais informações sobre o suporte ao HDR, consulte atualizações do IddCx versão 1.10.