次の方法で共有


戻り値の列挙型

戻り値の列挙型

次の一覧は、Microsoft® DirectInput® メソッドと関数が返す HRESULT 値を示す。エラーは負の値によって示され、結合することができない。

各メソッドまたは関数が返すエラー値の一覧については、それぞれの説明を参照すること。ドキュメントでのエラー コードの一覧は、完全なものではない。たとえば、DirectInput のいずれのメソッドも DIERR_OUTOFMEMORY を返すが、ドキュメントでは、このエラー コードはそのメソッドの可能な戻り値として明示されていない。

構文

typedef enum {
    DI_BUFFEROVERFLOW,
    DI_DOWNLOADSKIPPED,
    DI_EFFECTRESTARTED,
    DI_NOEFFECT,
    DI_NOTATTACHED,
    DI_OK,
    DI_POLLEDDEVICE,
    DI_PROPNOEFFECT,
    DI_SETTINGSNOTSAVED,
    DI_TRUNCATED,
    DI_TRUNCATEDANDRESTARTED,
    DI_WRITEPROTECT,
    DIERR_ACQUIRED,
    DIERR_ALREADYINITIALIZED,
    DIERR_BADDRIVERVER,
    DIERR_BETADIRECTINPUTVERSION,
    DIERR_DEVICEFULL,
    DIERR_DEVICENOTREG,
    DIERR_EFFECTPLAYING,
    DIERR_GENERIC,
    DIERR_HANDLEEXISTS,
    DIERR_HASEFFECTS,
    DIERR_INCOMPLETEEFFECT,
    DIERR_INPUTLOST,
    DIERR_INVALIDPARAM,
    DIERR_MAPFILEFAIL,
    DIERR_MOREDATA,
    DIERR_NOAGGREGATION,
    DIERR_NOINTERFACE,
    DIERR_NOTACQUIRED,
    DIERR_NOTBUFFERED,
    DIERR_NOTDOWNLOADED,
    DIERR_NOTEXCLUSIVEACQUIRED,
    DIERR_NOTFOUND,
    DIERR_NOTINITIALIZED,
    DIERR_OBJECTNOTFOUND,
    DIERR_OLDDIRECTINPUTVERSION,
    DIERR_OTHERAPPHASPRIO,
    DIERR_OUTOFMEMORY,
    DIERR_READONLY,
    DIERR_REPORTFULL,
    DIERR_UNPLUGGED,
    DIERR_UNSUPPORTED,
    E_HANDLE,
    E_PENDING,
    E_POINTER
} Return Values;

定数

  • DI_BUFFEROVERFLOW
    デバイス バッファがオーバーフローし、一部の入力が失われた。この値は、標準の COM 戻り値である S_FALSE に等しい。

  • DI_DOWNLOADSKIPPED
    エフェクトのパラメータの更新は成功したが、このエフェクトに関連するデバイスが排他モードで取得されていないので、このエフェクトをダウンロードできない。

  • DI_EFFECTRESTARTED
    エフェクトを停止し、そのパラメータの更新を行い、その後このエフェクトを再開した。

  • DI_NOEFFECT
    この操作にエフェクトはない。この値は、標準のコンポーネント オブジェクト モデル (COM) 戻り値である S_FALSE に等しい。

  • DI_NOTATTACHED
    デバイスは存在するが、現在はアタッチされていない。この値は、標準の COM 戻り値である S_FALSE に等しい。

  • DI_OK
    操作は完全に終了した。この値は、標準の COM 戻り値である S_OK に等しい。

  • DI_POLLEDDEVICE
    デバイスは、ポーリング対象デバイスである。その結果、デバイス バッファリングでデータは収集されず、イベントは、IDirectInputDevice8::Poll メソッドが呼び出されるまで通知されない。

  • DI_PROPNOEFFECT
    デバイス プロパティの変更は効果がなかった。この値は、標準の COM 戻り値である S_FALSE に等しい。

  • DI_SETTINGSNOTSAVED
    アクション マップはデバイスに適用されたが、設定情報は保存されなかった。

  • DI_TRUNCATED
    エフェクトのパラメータの更新は成功したが、パラメータのうちデバイスの能力を超えているものがあり、それらはサポートされる最も近い値に丸められた。

  • DI_TRUNCATEDANDRESTARTED
    DI_EFFECTRESTARTED | DI_TRUNCATED に等しい。

  • DI_WRITEPROTECT
    設定が変更できないことを示す成功コード。

  • DIERR_ACQUIRED
    操作は、デバイスが取得状態の間は実行できない。

  • DIERR_ALREADYINITIALIZED
    このオブジェクトは初期化済みである。

  • DIERR_BADDRIVERVER
    互換性のないドライバ バージョン、または不適格か不完全なドライバ コンポーネントが原因で、オブジェクトは作成できなかった。

  • DIERR_BETADIRECTINPUTVERSION
    アプリケーションは、DirectInput のサポートされていないリリース前のバージョン用に作成されたものである。

  • DIERR_DEVICEFULL
    デバイスはフルである。

  • DIERR_DEVICENOTREG
    デバイスまたはデバイス インスタンスが DirectInput に登録されていない。この値は、標準の COM 戻り値である REGDB_E_CLASSNOTREG に等しい。

  • DIERR_EFFECTPLAYING
    パラメータは、メモリ内では更新されたが、デバイスにはダウンロードされなかった。デバイスが再生中のエフェクトの更新をサポートしていないためである。

  • DIERR_GENERIC
    DirectInput サブシステムで 原因不明のエラーが発生した。この値は、標準の COM 戻り値である E_FAIL に等しい。

  • DIERR_HANDLEEXISTS
    デバイスは、既に自身にイベント通知を関連付けている。この値は、標準の COM 戻り値である E_ACCESSDENIED に等しい。

  • DIERR_HASEFFECTS
    デバイスは、エフェクトがデバイスにアタッチされているために再初期化できない。

  • DIERR_INCOMPLETEEFFECT
    必須情報がないので、エフェクトをダウンロードできなかった。たとえば、エフェクトに関連する軸がなかったり、タイプ固有の情報が与えられていない場合。

  • DIERR_INPUTLOST
    入力デバイスへのアクセスが失われた。再取得しなければならない。

  • DIERR_INVALIDPARAM
    無効なパラメータが戻ってくる関数に渡されたか、オブジェクトがその関数を呼び出せる状態になかった。この値は、標準の COM 戻り値である E_INVALIDARG に等しい。

  • DIERR_MAPFILEFAIL
    ベンダーが提供したデバイスのアクション マップ ファイルを読み取り中か、デバイスのユーザー構成アクション マップ ファイルを読み取り中または書き込み中にエラーが発生した。

  • DIERR_MOREDATA
    要求情報の一部がバッファに納まらなかった。

  • DIERR_NOAGGREGATION
    オブジェクトは集成化をサポートしていない。

  • DIERR_NOINTERFACE
    オブジェクトは、指定されたインターフェイスをサポートしていない。この値は、標準の COM 戻り値である E_NOINTERFACE に等しい。

  • DIERR_NOTACQUIRED
    操作は、デバイスが取得されない限り実行できない。

  • DIERR_NOTBUFFERED
    デバイスはバッファリングされていない。バッファリングを有効にするには、DIPROP_BUFFERSIZE プロパティを設定する。

  • DIERR_NOTDOWNLOADED
    エフェクトがダウンロードされていない。

  • DIERR_NOTEXCLUSIVEACQUIRED
    操作は、デバイスが DISCL_EXCLUSIVE モードで取得されていなければ実行できない。

  • DIERR_NOTFOUND
    要求されたオブジェクトは存在しない。

  • DIERR_NOTINITIALIZED
    このオブジェクトは初期化されていない。

  • DIERR_OBJECTNOTFOUND
    要求されたオブジェクトは存在しない。

  • DIERR_OLDDIRECTINPUTVERSION
    アプリケーションは、より新しいバージョンの DirectInput を必要とする。

  • DIERR_OTHERAPPHASPRIO
    他のアプリケーションの優先レベルの方が高いので、この呼び出しを実行できない。この値は、標準の DirectInput 戻り値である E_ACCESSDENIED に等しい。このエラーが返されるのは、アプリケーションのデバイスに対するアクセス権がフォアグラウンド アクセス権であるにもかかわらず、バックグラウンドにいるときにデバイスを取得しようとした場合である。

  • DIERR_OUTOFMEMORY
    DirectInput サブシステムが呼び出しを完了するのに十分なメモリを割り当てることができなかった。この値は、標準の COM 戻り値である E_OUTOFMEMORY に等しい。

  • DIERR_READONLY
    指定のプロパティは変更できない。この値は、標準の COM 戻り値である E_ACCESSDENIED に等しい。

  • DIERR_REPORTFULL
    送られる情報が、デバイスに送ることができる情報よりも多い。

  • DIERR_UNPLUGGED
    デバイスが接続されていないため、操作を完了できなかった。

  • DIERR_UNSUPPORTED
    呼び出した関数はこの時点ではサポートされていない。この値は、標準の COM 戻り値である E_NOTIMPL に等しい。

  • E_HANDLE
    このパラメータは、このプロセスに関係する有効な最上位のウィンドウ ハンドルでなければならない。

  • E_PENDING
    データは、まだ使用できない。

  • E_POINTER
    無効なポインタ (通常は NULL) がパラメータとして渡された。

列挙型の情報

最低限のオペレーティング システム Windows 98、Windows 2000、Windows XP