Función IddCxMonitorQueryHardwareCursor3 (iddcx.h)

Artículo
10/25/2023

Un controlador de pantalla indirecto llama a IddCxMonitorQueryHardwareCursor3 para recuperar la información actual del cursor de hardware para el monitor especificado. Esta versión de función agrega el nivel de blanco de SDR que un controlador debe aplicar al cursor si el monitor está en modo HDR.

Sintaxis

HRESULT IddCxMonitorQueryHardwareCursor3(
  IDDCX_MONITOR                 MonitorObject,
  const IDARG_IN_QUERY_HWCURSOR *pInArgs,
  IDARG_OUT_QUERY_HWCURSOR3     *pOutArgs
);

Parámetros

MonitorObject

[in] Objeto IDDCX_MONITOR que es el identificador de contexto del sistema operativo del monitor creado por IddCxMonitorCreate.

pInArgs

Puntero a una estructura de IDARG_IN_QUERY_HWCURSOR que contiene los argumentos de entrada de esta función.

pOutArgs

Puntero a una estructura IDARG_OUT_QUERY_HWCURSOR3 en la que se devuelve la información actual del cursor de hardware del monitor.

Valor devuelto

IddCxMonitorQueryHardwareCursor2 devuelve STATUS_SUCCESS tras el éxito; de lo contrario, devuelve un código de error NTSTATUS adecuado. Un código de error de STATUS_GRAPHICS_PATH_NOT_IN_TOPOLOGY es un error transitorio que indica que monitorObject no está actualmente en una ruta de acceso activa.

Comentarios

IddCxMonitorQueryHardwareCursor3 recupera la información actual del cursor de hardware para el monitor especificado y la coloca en el búfer proporcionado por el autor de la llamada al que apunta pOutArgs . Esta función es muy similar a IddCxMonitorQueryHardwareCursor2, pero además proporciona el valor de nivel de blanco de SDR. El nivel de blanco de SDR es necesario porque todas las imágenes de cursor están en formato SDR y el controlador debe asegurarse de que se muestran con el brillo correcto.

Para obtener más información sobre la compatibilidad con HDR, consulta Actualizaciones de IddCx versión 1.10.