IddCxMonitorQueryHardwareCursor3 函式（iddcx.h）

間接顯示驅動程式會呼叫 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 版更新。