Función IddCxAdapterSetRenderAdapter (iddcx.h)

IddCxAdapterSetRenderAdapter establece el adaptador de representación preferido en el que se van a representar las cadenas de intercambio para el adaptador especificado.

Sintaxis

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

Parámetros

[in] AdapterObject

Objeto de adaptador del adaptador para el que se establece la preferencia del adaptador de representación.

[in] pInArgs

Puntero a una estructura IDARG_IN_ADAPTERSETRENDERADAPTER que contiene argumentos de entrada a la función.

Valor devuelto

None

Observaciones

Un controlador de pantalla indirecto (IDD) puede llamar a IddCxAdapterSetRenderAdapter en cualquier momento para cambiar el adaptador de representación preferido. El controlador puede usar la enumeración Dxgi para buscar el LUID del adaptador de representación necesario.

El sistema operativo usará el adaptador de representación preferido del controlador de identificador siempre que sea posible. En algunos casos (por ejemplo, cuando el adaptador de representación preferido es PnpStopped), el sistema operativo puede elegir otro adaptador. El sistema operativo pasa el adaptador de representación real usado para una cadena de intercambio al controlador en la devolución de llamada EVT_IDD_CX_MONITOR_ASSIGN_SWAPCHAIN .

Se puede llamar a IddCxAdapterSetRenderAdapter en cualquier momento para cambiar el LUID de representación. El sistema operativo intentará usar inmediatamente este nuevo adaptador de representación para todos los monitores activos y volver a crear las cadenas de intercambio existentes en él. Los usuarios pueden ver algunos problemas visuales o artefactos a medida que el sistema operativo vuelve a configurar la composición del escritorio. Para evitar problemas, si el controlador conoce el adaptador de representación que se va a usar en el momento del inicio, el controlador debe llamar a IddCxAdapterSetRenderAdapter antes de agregar monitores y cambiarlo solo mientras las rutas de acceso estén activas si el usuario la ha solicitado explícitamente, por ejemplo a través de una aplicación complementaria del dispositivo.

IddCxAdapterSetRenderAdapter es compatible con adaptadores de id. remoto y de consola.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 10, versión 1903
Encabezado iddcx.h

Consulte también

IDARG_IN_ADAPTERSETRENDERADAPTER