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]カーソルが表示されている場合に OS が現在のカーソル情報をコピーする IDDCX_CURSOR_SHAPE_INFO 構造体。 カーソルが表示されない場合、OS はこの構造体をゼロにします。

PositionValid

[out]この構造体の X、Y、および PositionId フィールドが有効かどうかを示すブール値。

PositionId

[out]OS がこのモニターに対して受け取った最後のカーソル位置の ID。 ドライバーは、新しい位置の更新を処理する必要があるかどうかを知るために処理した最後のカーソル位置とこの ID を比較できます。

位置の値が変更されていない可能性がありますが、位置 ID の値が変更されている場合があることに注意してください。 この場合、ドライバーは新しい移動であるかのように位置を処理する必要があります。 PositionId は、IsCursorVisible が変更された場合は更新されず、PositionValid が TRUE の場合にのみ有効です。

SdrWhiteLevel

[out]HDR コンテンツを使用して合成するときに使用されるカーソルの白レベル (ニト単位)。

備考

HDR サポートの詳細については、iddCx バージョン 1.10 更新プログラム を参照してください。

必要条件

要件	価値
サポートされる最小クライアント	Windows 11 バージョン 22H2 September Update (IddCx バージョン 1.10)
ヘッダー	iddcx.h

関連項目

IddCxMonitorQueryHardwareCursor3の