GetRawInputData 関数 (winuser.h)
指定したデバイスから生の入力を取得します。
構文
UINT GetRawInputData(
[in] HRAWINPUT hRawInput,
[in] UINT uiCommand,
[out, optional] LPVOID pData,
[in, out] PUINT pcbSize,
[in] UINT cbSizeHeader
);
パラメーター
[in] hRawInput
型: HRAWINPUT
RAWINPUT 構造体へのハンドル。 これは、WM_INPUTの lParam に由来します。
[in] uiCommand
型: UINT
コマンド フラグ。 このパラメーターには、次の値のいずれかを指定できます。
| 値 | 意味 |
|---|---|
|
RAWINPUT 構造体からヘッダー情報を取得します。 |
|
RAWINPUT 構造体から生データを取得します。 |
[out, optional] pData
種類: LPVOID
RAWINPUT 構造体から取得されるデータへのポインター。 これは 、uiCommand の値によって異なります。 pData が NULL の場合、バッファーの必要なサイズは *pcbSize で返されます。
[in, out] pcbSize
型: PUINT
pData 内のデータのサイズ (バイト単位)。
[in] cbSizeHeader
型: UINT
RAWINPUTHEADER 構造体のサイズ (バイト単位)。
戻り値
型: UINT
pData が NULL で、関数が成功した場合、戻り値は 0 です。 pData が NULL ではなく、関数が成功した場合、戻り値は pData にコピーされたバイト数です。
エラーが発生した場合、戻り値は (UINT)-1 です。
注釈
GetRawInputData は、生入力を一度に 1 つの RAWINPUT 構造体で取得します。 これに対し、 GetRawInputBuffer は RAWINPUT 構造体の配列を取得します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows XP (デスクトップ アプリのみ) |
| サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
| 対象プラットフォーム | Windows |
| ヘッダー | winuser.h (Windows.h を含む) |
| Library | User32.lib |
| [DLL] | User32.dll |
| API セット | ext-ms-win-ntuser-rawinput-l1-1-0 (Windows 10 バージョン 10.0.14393 で導入) |
関連項目
概念
参照