戻り値の列挙型
戻り値の列挙型
次の一覧は、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 |