Função IddCxAdapterSetRenderAdapter (iddcx.h)

Artigo
02/07/2025

IddCxAdapterSetRenderAdapter define o adaptador de renderização preferencial no qual renderizar os swapchains para o adaptador especificado.

Sintaxe

void IddCxAdapterSetRenderAdapter(
  [in] IDDCX_ADAPTER                          AdapterObject,
  [in] const IDARG_IN_ADAPTERSETRENDERADAPTER *pInArgs
);

Parâmetros

[in] AdapterObject

Objeto adaptador do adaptador para o qual a preferência do adaptador de renderização está sendo definida.

[in] pInArgs

Ponteiro para uma estrutura IDARG_IN_ADAPTERSETRENDERADAPTER que contém argumentos de entrada para a função.

Valor de retorno

Nenhum

Observações

Um IDD (driver de exibição indireto) pode chamar IddCxAdapterSetRenderAdapter a qualquer momento para alterar o adaptador de renderização preferencial. O driver pode usar a enumeração Dxgi para localizar o LUID do adaptador de renderização necessário.

O sistema operacional usará o adaptador de renderização preferencial do driver de ID sempre que possível. Em alguns casos (por exemplo, quando o adaptador de renderização preferencial é PnpStopped), o sistema operacional pode escolher um adaptador diferente. O sistema operacional passa o adaptador de renderização real usado para uma troca para o driver no retorno de chamada EVT_IDD_CX_MONITOR_ASSIGN_SWAPCHAIN.

IddCxAdapterSetRenderAdapter pode ser chamado a qualquer momento para alterar o LUID de renderização. O sistema operacional tentará imediatamente usar esse novo adaptador de renderização para todos os monitores ativos, recriando qualquer swapchains existente nele. Os usuários podem ver algumas falhas visuais/artefatos à medida que o sistema operacional reconfigura a composição da área de trabalho. Para evitar falhas, se o driver souber que o adaptador de renderização deve ser usado no momento da inicialização, o driver deverá chamar IddCxAdapterSetRenderAdapter antes de adicionar monitores e alterá-lo somente enquanto os caminhos estiverem ativos se o usuário tiver solicitado explicitamente, por exemplo, por meio de um aplicativo complementar do dispositivo.

IddCxAdapterSetRenderAdapter tem suporte para adaptadores de ID remota e console.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 10, versão 1903
cabeçalho	iddcx.h

Consulte também

IDARG_IN_ADAPTERSETRENDERADAPTER

Partilhar via