Функция 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 |