Función IddCxAdapterSetRenderAdapter (iddcx.h)
IddCxAdapterSetRenderAdapter establece el adaptador de representación preferido en el que se representarán 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 de IDARG_IN_ADAPTERSETRENDERADAPTER que contiene argumentos de entrada a la función.
Valor devuelto
Ninguno
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 de 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. Es posible que los usuarios vean algunos problemas o artefactos visuales 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 de 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 se admite tanto para adaptadores de consola como de identificador remoto.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows 10, versión 1903 |
| encabezado de | iddcx.h |