RAWINPUTDEVICE 構造体 (winuser.h)

  • [アーティクル]

生入力デバイスの情報を定義します。

構文

typedef struct tagRAWINPUTDEVICE {
  USHORT usUsagePage;
  USHORT usUsage;
  DWORD  dwFlags;
  HWND   hwndTarget;
} RAWINPUTDEVICE, *PRAWINPUTDEVICE, *LPRAWINPUTDEVICE;

メンバーズ

usUsagePage

型: USHORT

raw 入力デバイスの [使用量] ページ最上位レベルのコレクションです。 使用可能な値の詳細については、Windows でサポートされている HID クライアントの を参照してください。

usUsage

型: USHORT

raw 入力デバイスの使用状況 ID最上位レベルのコレクションです。 使用可能な値の詳細については、Windows でサポートされている HID クライアントの を参照してください。

dwFlags

型: DWORD

usUsagePage および usUsageによって提供される情報 解釈する方法を指定するモード フラグ。 0 (既定値) または次のいずれかの値を指定できます。 既定では、オペレーティング システムは、ウィンドウフォーカスがある限り、指定された 最上位レベルのコレクション (TLC) を持つデバイスから登録済みアプリケーションに生入力を送信します。

価値 意味
RIDEV_REMOVE
0x00000001
 設定すると、最上位レベルのコレクションが包含リストから削除されます。 これにより、最上位のコレクションに一致するデバイスからの読み取りを停止するようにオペレーティング システムに指示します。
RIDEV_EXCLUDE
0x00000010
 設定されている場合は、完全な使用状況ページを読み取るときに除外する最上位レベルのコレクションを指定します。 このフラグは、使用ページが既に RIDEV_PAGEONLYで指定されている TLC にのみ影響します。
RIDEV_PAGEONLY
0x00000020
 設定すると、最上位レベルのコレクションが指定された usUsagePageからのすべてのデバイスが指定されます。 usUsage は 0 である必要があることに注意してください。 特定の最上位レベルのコレクションを除外するには、RIDEV_EXCLUDEを使用します。
RIDEV_NOLEGACY
0x00000030
 設定すると、usUsagePage または usUsage で指定されたデバイス レガシ メッセージ生成できなくなります。 これはマウスとキーボード専用です。 「解説」を参照してください。
RIDEV_INPUTSINK
0x00000100
 設定すると、呼び出し元がフォアグラウンドにいない場合でも、呼び出し元は入力を受け取ります。 hwndTarget 指定する必要があることに注意してください。
RIDEV_CAPTUREMOUSE
0x00000200
 設定した場合、マウス ボタンのクリックでは他のウィンドウはアクティブになりません。 RIDEV_CAPTUREMOUSE は、マウス デバイスに RIDEV_NOLEGACY が指定されている場合にのみ指定できます。
RIDEV_NOHOTKEYS
0x00000200
 設定した場合、アプリケーション定義のキーボード デバイスのホットキーは処理されません。 ただし、システムのホットキー。たとえば、Alt + Tab キーと Ctrl + Alt + DEL キーは引き続き処理されます。 既定では、すべてのキーボード ホットキーが処理されます。 RIDEV_NOLEGACY が指定されておらず、hwndTarget が NULL場合でも、RIDEV_NOHOTKEYS を指定できます。
RIDEV_APPKEYS
0x00000400
 設定すると、アプリケーション コマンド キーが処理されます。 RIDEV_APPKEYS は、キーボード デバイスに RIDEV_NOLEGACY が指定されている場合にのみ指定できます。
RIDEV_EXINPUTSINK
0x00001000
 設定すると、フォアグラウンド アプリケーションで処理されない場合にのみ、呼び出し元がバックグラウンドで入力を受け取ることができます。 つまり、フォアグラウンド アプリケーションが未加工の入力に登録されていない場合、登録されているバックグラウンド アプリケーションは入力を受け取ります。
Windows XP: このフラグは、Windows Vista までサポートされていません
RIDEV_DEVNOTIFY
0x00002000
 設定すると、呼び出し元は、デバイスの到着とデバイスの削除に関する WM_INPUT_DEVICE_CHANGE 通知を受信できます。
Windows XP: このフラグは、Windows Vista までサポートされていません

hwndTarget

型: HWND

ターゲット ウィンドウへのハンドル。 NULL場合、生入力イベントはキーボード フォーカスに従って、フォーカスされたアプリケーション ウィンドウのみがイベントを受け取れるようにします。

備考

マウスまたはキーボード RIDEV_NOLEGACY 設定されている場合、システムはアプリケーションのそのデバイスのレガシ メッセージを生成しません。 たとえば、マウス TLC が RIDEV_NOLEGACYで設定されている場合、WM_LBUTTONDOWN および 関連するレガシ マウス メッセージ 生成されません。 同様に、キーボード TLC が RIDEV_NOLEGACYで設定されている場合、WM_KEYDOWN および 関連するレガシ キーボード メッセージ 生成されません。

RIDEV_REMOVE が設定されていて、hwndTarget メンバーが NULL設定されていない場合、RegisterRawInputDevices 関数 失敗します。

必要条件

要件 価値
サポートされる最小クライアント Windows XP [デスクトップ アプリのみ]
サポートされる最小サーバー Windows Server 2003 [デスクトップ アプリのみ]
ヘッダー winuser.h (Windows.h を含む)

関連項目

概念

GetRegisteredRawInputDevices の

生入力 を する

ヒューマン インターフェイス デバイス (HID) の概要

Windows でサポートされている HID クライアントの

HID USB ホームページ

リファレンス

RegisterRawInputDevices の