IDARG_OUT_QUERY_HWCURSOR3結構 (iddcx.h)

IDARG_OUT_QUERY_HWCURSOR3結構是IddCxMonitorQueryHardwareCursor3用來傳回目前硬體數據指標相關信息的輸出參數。

語法

struct IDARG_OUT_QUERY_HWCURSOR3 {
  BOOL                    IsCursorVisible;
  INT                     X;
  INT                     Y;
  BOOL                    IsCursorShapeUpdated;
  IDDCX_CURSOR_SHAPE_INFO CursorShapeInfo;
  BOOL                    PositionValid;
  UINT                    PositionId;
  UINT                    SdrWhiteLevel;
};

成員

IsCursorVisible

[out]布爾值，指出數據指標是否可見。

X

[out]如果游標為可見 (IsCursorVisible = TRUE) 則 X 是游標影像中左上方圖元的 x 畫面座標。 只有當 PositionValid 為 TRUE 時，此字段才有效。 X 可以是負數;例如，當游標中央的作用點放在螢幕左上方時。

Y

[out]如果游標為可見 (IsCursorVisible = TRUE) 則 Y 是游標影像中左上方圖元的 y 畫面座標。 只有當 PositionValid 為 TRUE 時，此字段才有效。 Y 可以是負數;例如，當游標中央的作用點放在螢幕左上方時。

IsCursorShapeUpdated

[out]布爾值，指出自上次呼叫 IddCxMonitorQueryHardwareCursor3的驅動程序以來，數據指標圖形是否已更新。 如果已更新，OS 會更新 CursorShapeInfo 結構，並將新的數據指標映射數據複製到 IDARG_IN_QUERY_HWCURSOR。pShapeBuffer 緩衝區。

CursorShapeInfo

[out] IDDCX_CURSOR_SHAPE_INFO 結構，其中OS會在數據指標可見時複製目前的數據指標資訊。 如果看不到游標，則OS會以零這個結構。

PositionValid

[out]布爾值，指出這個結構中的 X、 Y 和 PositionId 欄位是否有效。

PositionId

[out]操作系統為此監視器收到的最後一個數據指標位置標識碼。 驅動程式可以將此標識碼與它處理的最後一個數據指標位置進行比較，以瞭解它是否應該處理新的位置更新。

請注意，在某些情況下，位置值可能未變更，但位置標識符值已變更。 在此情況下，驅動程式應該處理位置，就像是新的移動一樣。 如果IsCursorVisible變更，則PositionId不會更新，而且只有在PositionValid為TRUE時才有效。

SdrWhiteLevel

[out]使用 HDR 內容撰寫時，數據指標的白色層級，以 nits 表示使用。

備註

如需 HDR 支援的詳細資訊，請參閱 IddCx 1.10 版更新。

規格需求

需求	值
最低支援的用戶端	Windows 11 22H2 9 月更新 (IddCx 1.10 版)
標頭	iddcx.h

另請參閱

IddCxMonitorQueryHardwareCursor3