GetPointerPenInfo

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

GetPointerPenInfo pointerId, penInfo

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

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

解説

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

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

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

情報