次の方法で共有

GetRawInputDeviceInfoA 関数 (winuser.h)

  • [アーティクル]

生入力デバイスに関する情報を取得します。

構文

UINT GetRawInputDeviceInfoA(
  [in, optional]      HANDLE hDevice,
  [in]                UINT   uiCommand,
  [in, out, optional] LPVOID pData,
  [in, out]           PUINT  pcbSize
);

パラメーター

[in, optional] hDevice

型: HANDLE

生の入力デバイスへのハンドル。 これは、RAWINPUTHEADER の hDevice メンバー、または GetRawInputDeviceListから取得されます。

[in] uiCommand

型: UINT

pDataで返されるデータ 指定します。 このパラメーターには、次のいずれかの値を指定できます。

価値 意味
RIDI_PREPARSEDDATA
0x20000005
 pData は、最上位のコレクションの準備済みデータのバッファーへの PHIDP_PREPARSED_DATA ポインターです。
RIDI_DEVICENAME
0x20000007
 pData は、デバイス インターフェイス名を含む文字列を指します。

このデバイスが共有アクセス モード で開 場合は、この名前 CreateFile を呼び出して HID コレクションを開き、返されたハンドルを使用して、ReadFile を呼び出して入力レポートを読み取り、WriteFile を して出力レポートを送信できます。

詳細については、「HID コレクション を開く」および「HID レポートのを処理する 」を参照してください。

この uiCommand の場合のみ、pcbSize の値は文字数です (バイト数ではありません)。
RIDI_DEVICEINFO
0x2000000b
 pData は、RID_DEVICE_INFO 構造体を指します。

[in, out, optional] pData

型: LPVOID

uiCommandで指定された情報 含むバッファーへのポインター。

uiCommand が RIDI_DEVICEINFOされている場合は、getRawInputDeviceInfoを呼び出す前に、RID_DEVICE_INFO の cbSize メンバー に設定します。

[in, out] pcbSize

型: PUINT

pData内のデータのサイズ (バイト単位)。

戻り値

型: UINT

成功した場合、この関数は pDataにコピーされたバイト数を示す負の数 返します。

pData データに対して十分な大きさでない場合、関数は -1 を返します。 pData NULL場合、この関数は 0 の値を返します。 どちらの場合も、pcbSize は、pData バッファーに必要な最小サイズに設定されます。

GetLastError を呼び出して、他のエラーを特定します。

備考

手記

winuser.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして GetRawInputDeviceInfo を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。

必要条件

要件 価値
サポートされる最小クライアント Windows XP [デスクトップ アプリのみ]
サポートされる最小サーバー Windows Server 2003 [デスクトップ アプリのみ]
ターゲット プラットフォーム の ウィンドウズ
ヘッダー winuser.h (Windows.h を含む)
ライブラリ User32.lib
DLL User32.dll
API セットの ext-ms-win-ntuser-rawinput-l1-1-0 (Windows 10 バージョン 10.0.14393 で導入)

関連項目

概念

RAWINPUTHEADER の

RID_DEVICE_INFO

生入力 を する

リファレンス

WM_INPUT

Top-Level コレクションの

準備済みデータ

PHIDP_PREPARSED_DATA

HID コレクションを開く

HID レポートを処理する