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

Artigo
03/01/2024

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.

Retornar valor

EVT_IDD_CX_ADAPTER_COMMIT_MODES2 retorna um valor 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.

Comentários

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 são informados sobre o espaço de cor e os bits por componente a serem usados na conexão do monitor físico. Esses valores são baseados nos recursos de destino e nos parâmetros de modo relatados anteriormente pelo driver. Relatar o suporte do 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 a 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 ao 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 a HDR, consulte Atualizações do IddCx versão 1.10.