目次 - API(機能別) - HIDデバイス - SDL_hid_write

# SDL_hid_write

HIDデバイスに出力レポートを書き込む

## 構文

`int SDL_hid_write(SDL_hid_device *dev, const unsigned char *data, size_t length)`

## 引数

dev | SDL_hid_open()が戻したデバイスハンドル
data | 先頭バイトのレポート番号を含む送信データ.
maxlen | 送信するデータのバイト数

## 戻り値

実際に書き込んだバイト数を戻す. エラーのとき-1を戻す.

## 詳細

dataの先頭バイトは必ずレポートIDであること. 単一レポートのみ対応するデバイスは, 0x0をセットすること. 残りのバイトがレポートデータである. レポートIDは必須で, SDL_hid_write()にはレポート内容より常に1バイト多く渡すことになる. 例えばHIDレポートが16バイトならば, SDL_hid_write()にはレポートID(または0x0, 単一レポートのデバイスならば)とその後に続くレポートデータ(16バイト)の17バイトを渡さなければならない. lengthの値は17になる.

もし1つでもあれば, SDL_hid_write()はデータを最初のOUTエンドポイントに送信する. もしなければ, データをコントロールエンドポイント(エンドポイント0)に送信する.

## バージョン

SDL 2.0.18以降

## SDL Wikiへのリンク

SDL_hid_write - SDL Wiki