エラー コード
ここでは、DirectMusic のメソッドによって返されるさまざまなエラー コードについて簡単に説明する。各メソッドが返す特定のエラー コードのリストについては、個別のメソッドの説明を参照すること。これらのリストは必ずしも包括的なものとは限らない。
- DMUS_E_ALL_TRACKS_FAILED
- セグメント オブジェクトは、IStream オブジェクト データからすべてのトラックをロードできなかった。これは、ストリーム内でエラーが発生したか、トラックがクライアント上で不正に登録されていることが原因と考えられる。
- DMUS_E_ALREADY_ACTIVATED
- ポートは既にアクティブ化されており、パラメータは変更できない。
- DMUS_E_ALREADY_DOWNLOADED
- バッファは既にダウンロードされている。
- DMUS_E_ALREADY_EXISTS
- ツールはグラフ内に既に含まれている。新しいインスタンスを作成しなければならない。
- DMUS_E_ALREADY_INITED
- オブジェクトは既に初期化されている。
- DMUS_E_ALREADY_LOADED
- DLS コレクションは既に開いている。
- DMUS_E_ALREADY_SENT
- メッセージは既に送信されている。
- DMUS_E_ALREADYCLOSED
- ポートは開いていない。
- DMUS_E_ALREADYOPEN
- ポートは既に開いていた。
- DMUS_E_BADARTICULATION
- DLS コレクション内に無効なアーティキュレーション チャンクがある。
- DMUS_E_BADINSTRUMENT
- DLS コレクション内に無効な音色チャンクがある。
- DMUS_E_BADOFFSETTABLE
- オフセット テーブルにエラーがある。
- DMUS_E_BADWAVE
- ウェーブ ヘッダーが壊れている。
- DMUS_E_BADWAVELINK
- DLS コレクション内のウェーブリンク チャンクが無効なウェーブを指している。
- DMUS_E_BUFFER_EMPTY
- バッファ内にデータがない。
- DMUS_E_BUFFER_FULL
- 指定したバイト数が最大バッファ サイズを超えている。
- DMUS_E_BUFFERNOTAVAILABLE
- このバッファはダウンロードに利用できない。
- DMUS_E_BUFFERNOTSET
- データ用に準備されたバッファが存在しない。
- DMUS_E_CANNOT_OPEN_PORT
- デフォルトのシステム ポートを開くことができなかった。
- DMUS_E_DEVICE_IN_USE
- デバイスは既に使われており (おそらく DirectMusic 以外のクライアントによって)、再度開くことができない。
- DMUS_E_DMUSIC_RELEASED
- DirectMusic オブジェクトの最後のインスタンスが解放されたため、操作を実行できない。DirectMusic オブジェクトの最後の解放が終わるまで、ポートは使用できない。
- DMUS_E_DRIVER_FAILED
- ドライバまたはハードウェアでの障害の可能性を示す予想外のエラーがデバイス ドライバから返された。
- DMUS_E_DSOUND_ALREADY_SET
- DirectSound オブジェクトは既に設定されている。
- DMUS_E_DSOUND_NOT_SET
- DirectSound オブジェクトが指定されていないため、ポートを作成できなかった。
- DMUS_E_FAIL
- このメソッドは成功しなかった。
- DMUS_E_GET_UNSUPPORTED
- パラメータの取得はサポートしていない。
- DMUS_E_INSUFFICIENTBUFFER
- 要求された操作を実行するためのバッファが十分な大きさではない。
- DMUS_E_INVALIDARG
- 無効な引数。
- DMUS_E_INVALID_BAND
- ファイルに有効なバンドが含まれていない。
- DMUS_E_INVALID_DOWNLOADID
- ダウンロード バッファの作成プロセスで、無効なダウンロード識別子が使われた。
- DMUS_E_INVALID_EVENT
- イベントは、有効な MIDI メッセージではない、または動作ステータスを利用しておりバッファ内にパックできない。
- DMUS_E_INVALIDBUFFER
- 無効な DirectSound バッファがポートに渡された。
- DMUS_E_INVALIDFILE
- ファイルが無効である。
- DMUS_E_INVALIDPATCH
- コレクション内の音色がパッチ番号と一致しない。
- DMUS_E_INVALIDPOS
- DLS コレクションからウェーブ データを読み込み中にエラーが発生した。これは、不正なファイルであることを意味する。
- DMUS_E_LOADER_BADPATH
- ファイルパスが無効である。
- DMUS_E_LOADER_FAILEDCREATE
- オブジェクトが見つからなかった、または作成できなかった。
- DMUS_E_LOADER_FAILEDOPEN
- ファイルが存在していないかロックされているのが原因で、ファイルを開くことに失敗した。
- DMUS_E_LOADER_FORMATNOTSUPPORTED
- データ フォーマットがサポートされていないため、オブジェクトをロードできない。
- DMUS_E_LOADER_OBJECTNOTFOUND
- オブジェクトが見つからなかった。
- DMUS_E_NO_MASTER_CLOCK
- パフォーマンス内にマスタ クロックが存在しない。DirectMusicPerformance.Init メソッドを必ず呼び出すこと。
- DMUS_E_NOINTERFACE
- 利用可能なオブジェクト インターフェイスがない。
- DMUS_E_NOT_DOWNLOADED_TO_PORT
- オブジェクトがポート上にないため、アンロードできない。
- DMUS_E_NOT_FOUND
- 要求された項目はオブジェクトに含まれていない。
- DMUS_E_NOT_INIT
- 必要なオブジェクトは初期化されていないか、初期化に失敗した。
- DMUS_E_NOTADLSCOL
- ロード中のオブジェクトは有効な DLS コレクションではない。
- DMUS_E_NOTIMPL
- このメソッドは実装されていない。動作に必要な機能をドライバがサポートしていないために、このメソッドが返されることがある。
- DMUS_E_OUT_OF_RANGE
- 要求されたタイムはセグメントの範囲外である。
- DMUS_E_OUTOFMEMORY
- メモリ不足のため、タスクを完了できない。
- DMUS_E_PORT_NOT_RENDER
- 出力ポートではない。
- DMUS_E_PORTS_OPEN
- システム内の任意のプロセスにインスタンス化されたポートがあるときは、要求された操作を実行できない。
- DMUS_E_SEGMENT_INIT_FAILED
- セグメントの初期化に失敗した。メモリで重大な問題が発生したと考えられる。
- DMUS_E_SET_UNSUPPORTED
- パラメータの設定はサポートしていない。
- DMUS_E_TIME_PAST
- 要求されたタイムは過去のタイムである。
- DMUS_E_TRACK_NOT_FOUND
- 要求されたタイプのトラックがない。
- DMUS_E_TYPE_DISABLED
- パラメータは無効化されているため利用できない。
- DMUS_E_TYPE_UNSUPPORTED
- パラメータはこのトラック上でサポートされていない。
- DMUS_E_UNKNOWN_PROPERTY
- このポートにはプロパティ セットや項目が実装されていない。
- DMUS_E_UNSUPPORTED_STREAM
- ストリームは、ロード中のオブジェクトがサポートしているデータを含んでいない。