IDARG_OUT_QUERY_HWCURSOR2 構造体 (iddcx.h)

IDARG_OUT_QUERY_HWCURSOR2構造体は、現在のハードウェア カーソルに関する情報を返すために IddCxMonitorQueryHardwareCursor2 によって使用される出力パラメーターです。

構文

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

メンバー

IsCursorVisible

[out]カーソルが表示されるかどうかを示すブール値。

X

[out]カーソルが表示されている場合 (IsCursorVisible = TRUE)、 X はカーソルイメージ内の左上のピクセルの x 画面座標です。 このフィールドは、 PositionValid が TRUE の場合にのみ有効です。 X には負の値を指定できます。たとえば、カーソルの中央にあるホット スポットが画面の左上に配置されている場合などです。

Y

[out]カーソルが表示されている場合 (IsCursorVisible = TRUE)、 Y はカーソルイメージ内の左上のピクセルの y 画面座標です。 このフィールドは、 PositionValid が TRUE の場合にのみ有効です。 Y は負の値を指定できます。たとえば、カーソルの中央にあるホット スポットが画面の左上に配置されている場合などです。

IsCursorShapeUpdated

[out]ドライバーが IddCxMonitorQueryHardwareCursor2 を最後に呼び出してからカーソル図形が更新されたかどうかを示すブール値。 更新された場合、OS は CursorShapeInfo 構造体を更新し、新しいカーソル イメージ データを IDARG_IN_QUERY_HWCURSORにコピーします。pShapeBuffer バッファー。

CursorShapeInfo

[out] カーソルが 表示されている場合に OS が現在のカーソル情報をコピーするIDDCX_CURSOR_SHAPE_INFO構造体。 カーソルが表示されない場合、OS はこの構造体をゼロにします。

PositionValid

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

PositionId

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

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

要件

要件
サポートされている最小のクライアント Windows 11 バージョン 22H2
Header iddcx.h

こちらもご覧ください

IddCxMonitorQueryHardwareCursor2