Função IddCxAdapterDisplayConfigUpdate2 (iddcx.h)
Um driver remoto pode chamar IddCxAdapterDisplayConfigUpdate2 para permitir que um cliente informe ao servidor como atualizar a configuração do monitor.
Sintaxe
HRESULT IddCxAdapterDisplayConfigUpdate2(
IDDCX_ADAPTER AdapterObject,
const IDARG_IN_ADAPTERDISPLAYCONFIGUPDATE2 *pInArgs
);
Parâmetros
AdapterObject
[in] O objeto IDDCX_ADAPTER do adaptador remoto para o qual a configuração de exibição é especificada.
pInArgs
[in] Ponteiro para uma estrutura IDARG_IN_ADAPTERDISPLAYCONFIGUPDATE2 que contém argumentos de entrada para a função.
Valor de retorno
IddCxAdapterDisplayConfigUpdate2 retorna STATUS_SUCCESS após o sucesso; caso contrário, ele retorna um código de erro apropriado.
Observações
Um driver de exibição indireto remoto pode chamar IddCxAdapterDisplayConfigUpdate2 para definir o modo, a colorimetria e outros valores que o sistema operacional deve usar para um monitor específico. Somente drivers remotos são capazes de chamar essa função.
Para obter mais informações sobre o suporte ao HDR, consulte atualizações do IddCx versão 1.10.
A estrutura de IDDCX_DISPLAYCONFIGPATH2 é definida de forma que nem todas as informações precisam ser fornecidas em cada chamada. Por exemplo, alguns caminhos podem não fornecer dados de colorimetria se o modo de cor não for HDR ou WCG ou IddCxAdapterDisplayConfigUpdate2 poderão ser chamados para atualizar apenas o nível de branco SDR se nenhuma alteração de layout for necessária.
Controlar modos (definir o sinalizador de IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID para um caminho) tem algumas regras e esclarecimentos adicionais:
- Se qualquer caminho tiver IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID definido, todos os caminhos fornecidos deverão defini-lo
- Quando IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID é fornecido em todos os caminhos, os caminhos atualmente ativos que não estão na lista de caminhos ficarão inativos
- Se apenas sinalizadores nãoIDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID estiverem definidos, somente os caminhos a serem atualizados precisarão estar presentes
- Dependendo do modo de cor especificado, dados adicionais podem ser necessários para um caminho. A tabela a seguir indica quais sinalizadores adicionais devem ser definidos:
| Modo de cor | IDDCX_DISPLAYCONFIGPATH2_FLAGS_MONITOR_COLORIMETRY_VALID | IDDCX_DISPLAYCONFIGPATH2_FLAGS_MONITOR_SDRWHITELEVEL_VALID |
|---|---|---|
| SDR | Não | Não |
| SDRWCG | Sim | Não |
| HDR | Sim | Sim |
Primeira versus chamadas subsequentes para IddCxAdapterDisplayConfigUpdate2
A primeira vez que um caminho é incluído em um IddCxAdapterDisplayConfigUpdate2 chamada tem requisitos diferentes dos horários subsequentes. A tabela a seguir descreve os requisitos.
| Campo Caminho | Necessário na chamada inicial para o caminho | Pode ser atualizado após a chamada inicial | Como o cliente Windows obteria as informações |
|---|---|---|---|
| Modo | Sim | Sim | queryDisplayConfig fornecerá a configuração de exibição do cliente e WM_DISPLAYCHANGE será enviada quando a configuração de exibição for alterada; AdvancedColorInfo.CurrentAdvancedColorKind fornecerá um modo de cor |
| Fator de escala | Sim | Sim | Os drivers podem usar o método usado para IddCxAdapterDisplayConfigUpdate |
| Tamanho físico | Sim, se nenhum EDID passou | Não | Não é necessário se EDID passou |
| Colorimetria | Sim para o modo de cor não SDR | Sim | A maioria dos campos campos AdvancedColorInfo correspondentes |
| Nível de branco SDR | Sim para o modo de cor HDR, o padrão é 80 nits | Sim | AdvancedColorInfo.SdrWhiteLevelInNits, consulte DirectX com Cor Avançada no HDR/SDR exibe para obter mais informações |
Diferenças de comportamento ao executar no Windows 11, versão 22H2 Atualização de setembro
Devido à funcionalidade do sistema operacional subjacente, o suporte para drivers que solicitam modos de cores HDR e WCG ao serem executados no Windows 11, a versão 22H2 de Setembro Update difere ligeiramente de quando estiver em execução na versão da plataforma Windows em 2024. Um driver pode usar a função IddCxGetVersion para determinar em qual sistema operacional eles estão sendo executados. A tabela a seguir descreve quais modos de cor um driver pode solicitar, dependendo do descritor de monitor fornecido anteriormente para o sistema operacional:
| Tipo edid | 22H2 Atualização de setembro possíveis modos de cores | Versão da plataforma em 2024 possíveis modos de cores |
|---|---|---|
| Nenhum | SDR, HDR | SDR, SDRWCG, HDR |
| SDR | SDR, SDRWCG | SDR, SDRWCG |
| HDR | SDR, HDR | SDR, SDRWCG, HDR |
Exemplos
Alguns exemplos dos quais os caminhos a serem incluídos nas chamadas de IddCxAdapterDisplayConfigUpdate2 subsequentes são incluídos. No início de cada cenário, uma sessão remota tem os seguintes caminhos configurados:
| Monitor | Resolução | Posição da área de trabalho | Modo de cor |
|---|---|---|---|
| 1 | 1920x1080 @ 30Hz | 0,0 | SDR |
| 2 | 1024x768 @ 30Hz | 1024,0 | SDRWCG |
| 3 | 3840x2160 @ 30Hz | 0,1848 | HDR |
Cenário 1 – Alterar a posição da área de trabalho do Monitor 3 para ficar à esquerda do Monitor 1
| Monitor | Sinalizadores | Detalhes |
|---|---|---|
| 1 | IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID | Nenhuma alteração nos dados do modo atual |
| 2 | IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID | Nenhuma alteração nos dados do modo atual |
| 3 | IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID | Alterar a posição da área de trabalho para -3840,0 |
Cenário 2 – Alterar o monitor 2 de SDRWCG para SDR
| Monitor | Sinalizadores | Detalhes |
|---|---|---|
| 1 | IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID | Nenhuma alteração nos dados do modo atual |
| 2 | IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID | Definir novo modo de cor |
| 3 | IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID | Nenhuma alteração nos dados do modo atual |
Cenário 3 – Alterar o monitor 1 de SDR para HDR
| Monitor | Sinalizadores | Detalhes |
|---|---|---|
| 1 | IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID, IDDCX_DISPLAYCONFIGPATH2_FLAGS_MONITOR_COLORIMETRY_VALID, IDDCX_DISPLAYCONFIGPATH2_FLAGS_MONITOR_SDRWHITELEVEL_VALID | Definir novo modo de cor, colorimetria e nível de branco SDR |
| 2 | IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID | Nenhuma alteração nos dados do modo atual |
| 3 | IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID | Nenhuma alteração nos dados do modo atual |
Cenário 4 – Fator de escala de alteração do Monitor 2
| Monitor | Sinalizadores | Detalhes |
|---|---|---|
| 2 | IDDCX_DISPLAYCONFIGPATH2_FLAGS_MONITOR_SCALE_FACTOR_VALID | Definir novo fator de escala |
Cenário 5 – Alterar o fator de escala do Monitor 2 e a posição da área de trabalho do Monitor 3 a ser deixada do Monitor 1
| Monitor | Sinalizadores | Detalhes |
|---|---|---|
| 1 | IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID | Nenhuma alteração nos dados do modo atual |
| 2 | IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID, IDDCX_DISPLAYCONFIGPATH2_FLAGS_MONITOR_SCALE_FACTOR_VALID | Nenhuma alteração nos dados do modo atual, defina o novo fator de escala |
| 3 | IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID | Alterar a posição da área de trabalho para -3840,0 |
Cenário 6 – Remover o Monitor 2 da configuração atual
| Monitor | Sinalizadores | Detalhes |
|---|---|---|
| 1 | IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID | Nenhuma alteração nos dados do modo atual |
| 3 | IDDCX_DISPLAYCONFIGPATH2_FLAGS_MODE_VALID | Nenhuma alteração nos dados do modo atual |
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows 11, versão 22H2 Atualização de setembro (IddCx versão 1.10) |
| cabeçalho | iddcx.h |