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]この構造体の X、 Y、および PositionId フィールドが有効かどうかを示すブール値。
PositionId
[out]OS がこのモニターに対して受け取った最後のカーソル位置の ID。 ドライバーは、この ID を処理した最後のカーソル位置と比較して、新しい位置の更新を処理する必要があるかどうかを確認できます。
位置の値が変更されていない可能性がありますが、位置 ID の値が変更されている場合があることに注意してください。 この場合、ドライバーは新しい移動であるかのように位置を処理する必要があります。 IsCursorVisible が変更された場合、PositionId は更新されず、PositionValid が TRUE の場合にのみ有効です。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows 11 バージョン 22H2 |
Header | iddcx.h |