Функция IddCxMonitorQueryHardwareCursor3 (iddcx.h)

  • Статья

Драйвер непрямого дисплея вызывает IddCxMonitorQueryHardwareCursor3 для получения сведений о текущем аппаратном курсоре для указанного монитора. Эта версия функции добавляет уровень белого SDR, который драйвер должен применять к курсору, если монитор находится в режиме HDR.

Синтаксис

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

Параметры

MonitorObject

[in] Объект IDDCX_MONITOR , представляющий собой дескриптор контекста ОС монитора, созданный iddCxMonitorCreate.

pInArgs

Указатель на структуру IDARG_IN_QUERY_HWCURSOR , содержащую входные аргументы этой функции.

pOutArgs

Указатель на структуру IDARG_OUT_QUERY_HWCURSOR3 , в которой возвращаются сведения о текущем аппаратном курсоре монитора.

Возвращаемое значение

IddCxMonitorQueryHardwareCursor2 возвращает STATUS_SUCCESS при успешном выполнении; В противном случае возвращается соответствующий код ошибки NTSTATUS. Код ошибки STATUS_GRAPHICS_PATH_NOT_IN_TOPOLOGY является временной ошибкой, указывающей, что MonitorObject в настоящее время не находится в активном пути.

Комментарии

IddCxMonitorQueryHardwareCursor3 извлекает сведения о текущем аппаратном курсоре для указанного монитора и помещает их в буфер, предоставленный вызывающим объектом, на который указывает pOutArgs . Эта функция очень похожа на IddCxMonitorQueryHardwareCursor2, но дополнительно предоставляет значение уровня белого SDR. Белый уровень SDR является обязательным, так как все изображения курсоров имеют формат SDR, а драйвер должен убедиться, что они отображаются с правильной яркостью.

Дополнительные сведения о поддержке HDR см. в разделе Обновления IddCx версии 1.10.

Требования

Требование Значение
Минимальная версия клиента Windows 11, версия 22H2 сентябрьское обновление (IddCx версии 1.10)
Верхняя часть iddcx.h

См. также раздел

IDDCX_MONITOR

IDARG_IN_QUERY_HWCURSOR

IDARG_OUT_QUERY_HWCURSOR3

IddCxMonitorSetupHardwareCursor