GetPointerTouchInfoHistory

指定ポインタ(PT_TOUCH 型)について、現在のメッセージに統合された個々の入力に関連付けられたタッチベースの情報を取得する。

GetPointerTouchInfoHistory pointerId, entriesCount, touchInfo

pointerId : [int] 情報を取得する対象のポインタ識別子。
entriesCount : [var] touchInfo が指すバッファ内の構造体数を指定する変数へのポインタ。GetPointerTouchInfoHistory が成功した場合、利用可能な構造体の総数で entriesCount が更新される。この総数は GetPointerInfo または GetPointerTouchInfo が返す POINTER_INFO 構造体の historyCount フィールドと同じ値である。
touchInfo : [var] ポインタ情報を受け取る POINTER_TOUCH_INFO 構造体配列のアドレス。*entriesCount がゼロの場合は NULL でもよい。

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

解説

指定ポインタ(PT_TOUCH 型)について、現在のメッセージに統合された個々の入力に関連付けられたタッチベースの情報を取得する。

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

[備考]

アプリケーションがポインタ入力メッセージを生成速度ほど速く処理できない場合、一部の移動が統合されることがある。統合可能なポインタ(PT_TOUCH
型)メッセージを受け取った際、アプリケーションは GetPointerTouchInfoHistory
を使ってメッセージに統合された個々の入力情報をすべて取得できる。取得される情報は呼び出しスレッドがもっとも最近取得したポインタメッセージに関連付けられるため、次のメッセージが取得されると失われる可能性がある。取得される情報は逆時系列順で、最新エントリが配列の
1 行目に入る。最新エントリは GetPointerTouchInfo
が返すものと同じである。提供バッファの行数が利用可能な履歴エントリ全部を収めるのに不十分な場合、関数は成功し、バッファには最新エントリ群が入り、*entriesCount
には利用可能なエントリ総数が入る。

フレームに指定ポインタ以外のポインタが含まれない場合、関数は成功して指定ポインタの情報のみを返す。フレーム情報がもう利用できない場合、関数は失敗し最終エラーが
ERROR_NO_DATA
に設定される。呼び出しスレッドがポインタメッセージが配信されたウィンドウ(あるいは転送先ウィンドウ)を所有していない場合、関数は失敗し最終エラーが
ERROR_ACCESS_DENIED に設定される。指定ポインタが PT_TOUCH 型でない場合、関数は失敗し最終エラーが
ERROR_DATATYPE_MISMATCH に設定される。

情報