IDirectInputDevice8::SendDeviceData メソッド

IDirectInputDevice8::SendDeviceData メソッド

出力を受け付けるデバイスにデータを送信する。

注   IDirectInputDevice8::SendDeviceData からの出力を受け付けるデバイスはない。「注意」を参照すること。

構文

HRESULT SendDeviceData(      
    DWORD cbObjectData,
    LPCDIDEVICEOBJECTDATA rgdod,
    LPDWORD pdwInOut,
    DWORD fl
);

パラメータ

• cbObjectData
  単一の DIDEVICEOBJECTDATA 構造体のサイズ (バイト単位)。
• rgdod
  デバイスに送信するデータを格納した DIDEVICEOBJECTDATA 構造体の配列。
• pdwInOut
  呼び出し時は、このパラメータが指す変数には、rgdod が指す配列の要素数が含まれる。終了時は、デバイスに送信された要素数が含まれる。
• fl
  データの送信方法を制御するフラグ。ゼロまたは次の値を指定できる。
  • DISDD_CONTINUE
    送信されるデバイス データは、以前に送信されたデバイス データに上書きされる。

戻り値

成功した場合は、DI_OK を返す。

失敗した場合は、次のいずれかのエラー値を返す。

DIERR_INPUTLOST	入力デバイスへのアクセスが失われた。再取得しなければならない。
DIERR_NOTACQUIRED	操作は、デバイスが取得されない限り実行できない。
DIERR_REPORTFULL	送られる情報の方が、デバイスに送ることができる情報よりも多い。
DIERR_UNPLUGGED	この操作は、デバイスが接続されていないため完了できなかった。

注意

アプリケーションは、IDirectInputDevice8::SendDeviceData を使ってはならない。フォース フィードバックが、デバイスにデータを送信するための推奨の方法である。LED や内部デバイス状態の変更など、その他のデータをデバイスに送信する場合は、HID アプリケーション プログラミング インターフェイス (API) が推奨の方法である。