EVT_IDD_CX_MONITOR_QUERY_TARGET_MODES2 función de devolución de llamada (iddcx.h)
El sistema operativo llama a EVT_IDD_CX_MONITOR_QUERY_TARGET_MODES2 para obtener una lista de los modos de destino admitidos por el controlador para un monitor conectado al punto de conexión. Esta devolución de llamada es similar a EVT_IDD_CX_MONITOR_QUERY_TARGET_MODES, pero permite al controlador notificar información adicional para los modos de destino HDR10 y WCG.
Sintaxis
EVT_IDD_CX_MONITOR_QUERY_TARGET_MODES2 EvtIddCxMonitorQueryTargetModes2;
NTSTATUS EvtIddCxMonitorQueryTargetModes2(
IDDCX_MONITOR MonitorObject,
const IDARG_IN_QUERYTARGETMODES2 *pInArgs,
IDARG_OUT_QUERYTARGETMODES *pOutArgs
)
{...}
Parámetros
MonitorObject
[in] Identificador de contexto generado por el sistema operativo que identifica el monitor para generar una lista de modos de destino. Este objeto IDDCX_MONITOR se devolvió en una llamada anterior a IddCxMonitorCreate.
pInArgs
[in] Puntero a una estructura de IDARG_IN_QUERYTARGETMODES2 que contiene argumentos de entrada usados por EVT_IDD_CX_MONITOR_QUERY_TARGET_MODES2.
pOutArgs
[out] Puntero a una estructura de IDARG_OUT_QUERYTARGETMODES que contiene argumentos de salida generados por EVT_IDD_CX_MONITOR_QUERY_TARGET_MODES2.
Valor devuelto
EVT_IDD_CX_MONITOR_QUERY_TARGET_MODES2 devuelve un valor NTSTATUS . Si la operación se realiza correctamente, devuelve STATUS_SUCCESS u otro valor de estado para el que NT_SUCCESS(status) es igual a TRUE. De lo contrario, devuelve un código de error NTSTATUS adecuado.
Comentarios
Esta función es similar a EVT_IDD_CX_PARSE_MONITOR_DESCRIPTION2 en que permite a los controladores notificar la misma información de modo adicional. Un controlador que admita HDR debe implementar esta función; Los controladores que no admiten HDR solo pueden exponer la función EVT_IDD_CX_MONITOR_QUERY_TARGET_MODES existente.
El campo IDDCX_TARGET_MODE2::BitsPerComponent permite que se notifiquen varios formatos y profundidades de bits en un solo modo. Por ejemplo, un controlador puede notificar 8 y 10 bits por componente en RGB estableciendo tanto IDDCX_BITS_PER_COMPONENT_8 comoIDDCX_BITS_PER_COMPONENT_10 en IDDCX_TARGET_MODE2::BitsPerComponent::Rgb. Un controlador solo debe notificar bits diferentes por componente como modos únicos si otros detalles del modo también difieren.
Los controladores que devuelven modos con parámetros WCG o HDR de SDR producirán un error si no han notificado también IDDCX_ADAPTER_FLAGS_CAN_PROCESS_FP16 en la llamada IddCxAdapterInitAsync . SDR WCG y HDR IDDCX_WIRE_BITS_PER_COMPONENT. Los parámetros BitsPerComponent son:
- Cualquier valor de Rgb distinto de IDDCX_BITS_PER_COMPONENT_8, o
- Cualquier valor de YCbCr444, YCbCr422 o YCbCr420 distinto de IDDCX_BITS_PER_COMPONENT_NONE.
Para obtener más información sobre la compatibilidad con HDR, consulta Actualizaciones de IddCx versión 1.10.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 11, versión 22H2 actualización de septiembre (IddCx versión 1.10) |
| Encabezado | iddcx.h |