IddCxMonitorQueryHardwareCursor3 函式 (iddcx.h)

發行項
02/29/2024

間接顯示驅動程式會呼叫 IddCxMonitorQueryHardwareCursor3 ，以擷取指定監視器目前的硬體數據指標資訊。如果監視器處於 HDR 模式，此函式版本會新增驅動程式必須套用至游標的 SDR 白色層級。

語法

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

參數

MonitorObject

[in] IDDCX_MONITOR 物件，這是 IddCxMonitorCreate所建立的監視器OS內容句柄。

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 版更新。