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で導入)

こちらもご覧ください

CloseTouchInputHandle

関数

TOUCHINPUT