GetTouchInputInfo 関数 (winuser.h)
特定のタッチ入力ハンドルに関連付けられているタッチ入力に関する詳細情報を取得します。
構文
BOOL GetTouchInputInfo(
[in] HTOUCHINPUT hTouchInput,
[in] UINT cInputs,
[out] PTOUCHINPUT pInputs,
[in] int cbSize
);
パラメーター
[in] hTouchInput
タッチ メッセージの LPARAM で受信したタッチ入力ハンドル。 このハンドルが無効な場合、 関数は ERROR_INVALID_HANDLE で失敗します。 CloseTouchInputHandle の呼び出しに成功した後、または DefWindowProc、PostMessage、SendMessage、またはそのバリアントのいずれかに渡された後、ハンドルは無効であることに注意してください。
[in] cInputs
pInputs 配列内の構造体の数。 これは、メッセージ WPARAM に示されているように、メッセージに関連付けられているタッチ ポイントの数と少なくとも等しいのが理想的です。 cInputs がタッチ ポイントの数より少ない場合、関数は引き続き成功し、pInputs バッファーに cInputs タッチ ポイントに関する情報を設定します。
[out] pInputs
指定したタッチ入力ハンドルに関連付けられているタッチ ポイントに関する情報を受け取る TOUCHINPUT 構造体の配列へのポインター。
[in] cbSize
1 つの TOUCHINPUT 構造体のサイズ (バイト単位)。 cbSize が 1 つの TOUCHINPUT 構造体のサイズでない場合、関数は ERROR_INVALID_PARAMETER で失敗します。
戻り値
関数が成功すると、戻り値は 0 以外になります。 関数が失敗した場合は、0 を返します。 拡張エラー情報を取得するには、 GetLastError 関数を使用します。
注釈
CloseTouchInputHandle を呼び出すと、GetTouchInputInfo の呼び出しで取得された値に関連付けられているメモリは解放されません。 GetTouchInputInfo に渡される構造体の値は、削除するまで有効です。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 7 [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2008 R2 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | winuser.h (Windows.h を含む) |
| Library | User32.lib |
| [DLL] | User32.dll |
| API セット | ext-ms-win-ntuser-misc-l1-2-0 (Windows 8.1で導入) |