次の方法で共有


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) が推奨の方法である。