JAJA452A january   2011  – may 2023

 

  1.   1
  2. 1MSP430™ USB HID Windows API プログラマー・ガイド
  3. 2はじめに
  4. 3実装
    1. 3.1 概要
    2. 3.2 ファイル構成
    3. 3.3 システム要件
    4. 3.4 MSP430 USB API スタック
    5. 3.5 Windows が物理 USB HID デバイスをホスト・アプリケーションにマッピングする方法
    6. 3.6 システム上で特定の HID デバイス / インターフェイスを見つけて開く
    7. 3.7 データの送受信
    8. 3.8 HID デバイスの動的接続 / 切断の検出
  5. 4関数呼び出しのリファレンス
    1. 4.1 デバイス接続管理および初期化呼び出し
      1. 4.1.1 VOID HID_Init(struct strHidDevice* pstrHidDevice)
      2. 4.1.2 DWORD HID_GetSerNums(WORD vid, WORD pid, struct strTrackSerialNumbers *serialNumList)
      3. 4.1.3 DWORD HID_GetNumOfInterfaces(WORD vid, WORD pid, DWORD numSerNums)
      4. 4.1.4 BYTE HID_Open(struct strHidDevice* pstrHidDevice, WORD vid, WORD pid, DWORD deviceIndex, char serialNumber[SERNUM_LEN], DWORD totalDevNum, DWORD totalSerNum)
      5. 4.1.5 BYTE HID_Close(struct strHidDevice* pstrHidDevice)
      6. 4.1.6 BYTE HID_GetVersionNumber(struct strHidDevice* pstrHidDevice, USHORT * VersionNumber)
    2. 4.2 データの送受信
      1. 4.2.1 BYTE HID_WriteFile(struct strHidDevice* pstrHidDevice, BYTE* buffer, DWORD bufferSize, DWORD* bytesSent)
      2. 4.2.2 BYTE HID_ReadFile(struct strHidDevice* pStrHidDevice, BYTE* buffer, DWORD bufferSize, DWORD* bytesReturned)
    3. 4.3 プラグ・アンド・プレイ管理
      1. 4.3.1 BYTE HID_RegisterForDeviceNotification(HWND hWnd, HDEVNOTIFY* diNotifyHandle)
      2. 4.3.2 BYTE HID_UnregisterForDeviceNotification(HDEVNOTIFY* diNotifyHandle)
      3. 4.3.3 BOOL IsDeviceAffected(struct strHidDevice* pstrHidDevice)
  6. 5デモ・アプリケーション
  7. 6MSP430 USB ツール・スイート
  8.   HID インターフェイスのデータ構造体：strHidDevice
  9.   HID-Datapipe デバイスに関するレポートの形式
  10.   C 関連資料
  11.   C 改訂履歴

4.1.2 DWORD HID_GetSerNums(WORD vid, WORD pid, struct strTrackSerialNumbers *serialNumList)

概要

この vid と pid の組み合わせに関連するシステム上の物理 USB デバイスの数を返します。(これらのデバイスは、HID またはその他のタイプの場合があります。)デバイスが接続されていない場合は、0 を返します。デバイスが接続されている場合、渡された strTrackSerialNumbers 構造体に、見つけられた物理デバイスに対応するシリアル番号が入力され、この関数はリスト内のシリアル番号の総数を返します。

返された結果が複数である場合は、vid/pid の組み合わせを持つ物理デバイスが複数存在することを意味します。

パラメータ

表 4-3 HID_GetSerNums() のパラメータ
WORD vid検索するデバイスの 16 ビットのベンダ ID。
WORD pid検索するデバイスの 16 ビットのプロダクト ID。
struct strTrackSerialNumbers *serialNumListvid/pid に関連付けられているシリアル番号のリストを格納する構造体。
この関数は、見つかったシリアル番号を構造体に格納します。
戻り値0：この VID/PID を持つ物理 USB デバイスが接続されていない場合。
0 以外：この VID/PID を持つシステム上の物理 USB デバイスの数。
表 4-4 strTrackSerialNumbers 構造体の定義
フィールド概要
DWORD deviceNum物理 USB デバイスを表すインデックス番号。
char serialNum[SERNUM_LEN];検出された物理デバイスのシリアル番号を格納する文字列。