Compartilhar via


Função IddCxAdapterDisplayConfigUpdate (iddcx.h)

Um driver remoto pode chamar IddCxAdapterDisplayConfigUpdate para permitir que um cliente informe ao servidor como atualizar a configuração do monitor. Um driver que relata o suporte a HDR deve usar IddCxAdapterDisplayConfigUpdate2 .

Sintaxe

NTSTATUS IddCxAdapterDisplayConfigUpdate(
  IDDCX_ADAPTER                             AdapterObject,
  const IDARG_IN_ADAPTERDISPLAYCONFIGUPDATE *pInArgs
);

Parâmetros

AdapterObject

[in] O objeto IDDCX_ADAPTER do adaptador remoto para o qual a configuração de exibição está especificada.

pInArgs

[in] Ponteiro para uma estrutura IDARG_IN_ADAPTERDISPLAYCONFIGUPDATE que contém argumentos de entrada para a função.

Retornar valor

IddCxAdapterDisplayConfigUpdate retorna STATUS_SUCCESS após o sucesso; caso contrário, ele retornará um código de erro apropriado. Consulte Observações.

Comentários

Um driver de exibição indireto remoto (IDD) chama IddCxAdapterDisplayConfigUpdate quando recebe uma nova configuração de exibição.

O sistema operacional retornará STATUS_SUCCESS se tiver armazenado a configuração de exibição recém-especificada. Essas alterações reconfigurarão de forma assíncrona os swapchains para os monitores conforme solicitado. IddCxAdapterDisplayConfigUpdate primeiro liberará todas as chegadas pendentes do monitor e processará partidas para garantir que a lista de monitores seja atual.

Se IddCxAdapterDisplayConfigUpdate determinar que a configuração de exibição fornecida não tem suporte no momento pelo driver, ela retornará STATUS_INVALID_PARAMETER e registrará o motivo usando o WPP para fins de depuração. Por exemplo, um driver pode não dar suporte a uma taxa de resolução/atualização especificada ou um monitor inválido pode ser especificado.

IddCxAdapterDisplayConfigUpdate retornará STATUS_GRAPHICS_INDIRECT_DISPLAY_DEVICE_STOPPED se a sessão em que essa alteração de configuração for direcionada for desconectada ou se o adaptador de sessão estiver sendo interrompido.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 10, versão 1903
Cabeçalho iddcx.h

Confira também

IDARG_IN_ADAPTERDISPLAYCONFIGUPDATE

IddCxAdapterDisplayConfigUpdate2