RAWINPUTDEVICE 構造体 (winuser.h)
未加工の入力デバイスの情報を定義します。
構文
typedef struct tagRAWINPUTDEVICE {
USHORT usUsagePage;
USHORT usUsage;
DWORD dwFlags;
HWND hwndTarget;
} RAWINPUTDEVICE, *PRAWINPUTDEVICE, *LPRAWINPUTDEVICE;
メンバー
usUsagePage
種類: USHORT
生の入力デバイスの最上位レベルのコレクションの [使用状況] ページ。 使用可能な値の詳細については、「 Windows でサポートされている HID クライアント 」を参照してください。
usUsage
種類: USHORT
生の入力デバイスの最上位レベルのコレクションの使用状況 ID。 使用可能な値の詳細については、「 Windows でサポートされている HID クライアント 」を参照してください。
dwFlags
型: DWORD
usUsagePage と usUsage によって提供される情報を解釈する方法を指定する Mode フラグ。 0 (既定値) または次のいずれかの値を指定できます。 既定では、オペレーティング システムは、ウィンドウ フォーカスがある限り、指定された 最上位レベル コレクション (TLC) を持つデバイスから登録済みアプリケーションに生入力を送信します。
| 値 | 意味 |
|---|---|
|
設定すると、最上位レベルのコレクションが包含リストから削除されます。 これにより、最上位のコレクションに一致するデバイスからの読み取りを停止するようにオペレーティング システムに指示します。 |
|
設定されている場合、完全な使用状況ページを読み取るときに除外する最上位レベルのコレクションを指定します。 このフラグは、使用ページが 既に RIDEV_PAGEONLY で指定されている TLC にのみ影響します。 |
|
設定すると、指定した usUsagePage から最上位レベルのコレクションを持つすべてのデバイスが指定されます。 usUsage は 0 である必要があることに注意してください。 特定の最上位レベルのコレクションを除外するには、RIDEV_EXCLUDEを使用 します。 |
|
設定すると、 usUsagePage または usUsage で指定されたデバイスで レガシ メッセージが生成されなくなります。 これは、マウスとキーボード専用です。 「解説」を参照してください。 |
|
設定すると、呼び出し元がフォアグラウンドにない場合でも、呼び出し元は入力を受け取ることができます。 hwndTarget を指定する必要があることに注意してください。 |
|
設定した場合、マウス ボタンのクリックでは他のウィンドウはアクティブになりません。 RIDEV_CAPTUREMOUSE は、マウス デバイス にRIDEV_NOLEGACY が指定されている場合にのみ指定できます。 |
|
設定した場合、アプリケーション定義のキーボード デバイスホットキーは処理されません。 ただし、システム のホットキー。たとえば、Alt + Tab キーと Ctrl + Alt + DEL キーは引き続き処理されます。 既定では、すべてのキーボード ホットキーが処理されます。 RIDEV_NOLEGACYが指定されておらず、hwndTarget が NULL の場合でも、RIDEV_NOHOTKEYSを指定できます。 |
|
設定すると、アプリケーション コマンド キーが処理されます。 RIDEV_APPKEYS は、キーボード デバイス にRIDEV_NOLEGACY が指定されている場合にのみ指定できます。 |
|
設定すると、フォアグラウンド アプリケーションで処理されない場合にのみ、呼び出し元がバックグラウンドで入力を受け取ることができます。 つまり、フォアグラウンド アプリケーションが未加工の入力に登録されていない場合、登録されているバックグラウンド アプリケーションは入力を受け取ります。
Windows XP: このフラグは、Windows Vista までサポートされていません |
|
設定すると、呼び出し元は、デバイスの到着とデバイスの削除に関する 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 (デスクトップ アプリのみ) |
| Header | winuser.h (Windows.h を含む) |
関連項目
概念
参照
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示