Função IddCxAdapterSetRenderAdapter (iddcx.h)

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 adapter 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.

Retornar valor

Nenhum

Comentários

Um driver de exibição indireto (IDD) 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 cadeia de 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 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 o tiver solicitado explicitamente, por exemplo, por meio de um aplicativo complementar do dispositivo.

Há suporte para IddCxAdapterSetRenderAdapter para adaptadores de ID remotos e console.

Requisitos

Confira também

IDARG_IN_ADAPTERSETRENDERADAPTER