GetPointerTouchInfo

現在のメッセージに関連付けられた指定ポインタ(PT_TOUCH 型)のタッチベースの情報を取得する。

GetPointerTouchInfo pointerId, touchInfo

pointerId : [int] 情報を取得する対象のポインタ識別子。
touchInfo : [var] タッチ固有のポインタ情報を受け取る POINTER_TOUCH_INFO 構造体のアドレス。

(プラグイン / モジュール : user32.dll)

解説

現在のメッセージに関連付けられた指定ポインタ(PT_TOUCH 型)のタッチベースの情報を取得する。

[戻り値]
関数が成功した場合、戻り値は非ゼロである。関数が失敗した場合、戻り値はゼロである。拡張エラー情報を取得するには GetLastError
を呼ぶ。

[備考]
GetPointerTouchInfo は、ポインタメッセージに関連付けられた単一のポインタ(PT_TOUCH
型)情報を取得する。ポインタ集合のフレーム情報を取得するには GetPointerFrameTouchInfo
を使用する。GetPointerTouchInfo
が返す情報は呼び出しスレッドがもっとも最近取得したポインタメッセージに関連付けられており、次のメッセージが取得されると失われる可能性がある。アプリケーションがポインタ入力メッセージを生成速度ほど速く処理できない場合、一部のメッセージが
WM_POINTERUPDATE メッセージに統合されることがある。直近の WM_POINTERUPDATE
メッセージからメッセージ履歴を取得するには GetPointerTouchInfoHistory
を使用する。メッセージに関連付けられた情報がもう利用できない場合、関数は失敗し最終エラーが ERROR_NO_DATA
に設定される。呼び出しスレッドがポインタメッセージが配信されたウィンドウを所有していない場合、関数は失敗し最終エラーが
ERROR_ACCESS_DENIED
に設定される。これは入力が元々配信されたウィンドウ、あるいはメッセージが転送されたウィンドウである可能性がある。指定ポインタが
PT_TOUCH 型でない場合、関数は失敗し最終エラーが ERROR_DATATYPE_MISMATCH に設定される。

情報