指定された DirectMusic オブジェクトをファイルまたはリソースから取り出して、指定されたインターフェースを返します。
HRESULT GetObject(
LPDMUS_OBJECTDESC pDesk,
REFIID riid,
LPVOID *ppv
);
メソッドのインデックス： 3
取り出すオブジェクトの情報を格納した DMUS_OBJECTDESC 構造体のアドレスを指定します。
取得するインターフェース ID への参照を指定します。
インターフェースポインタを格納する変数のアドレスを指定します。
成功すると 0x00000000 (S_OK) が返ります。
部分的ロードのみできた場合は、0x08781091 (DMUS_S_PARTIALLOAD) が返ります。
失敗すると以下のいずれかのエラー値が返ります。
| 値 | 意味 |
|---|---|
| 0x80004003 (E_POINTER) | 無効なポインタが渡されました。 |
| 0x80040154 (REGDB_E_CLASSNOTREG) | 指定されたオブジェクトクラスが登録されていません。 |
| 0x80070057 (E_FAIL) | メソッドが失敗しました。 |
| 0x80070057 (E_INVALIDARG) | 無効な引数が渡されました。 |
| 0x8007000E (E_OUTOFMEMORY) | メモリ不足のため完了できませんでした。 |
| 0x88781180 (DMUS_E_LOADER_NOCLASSID) | DMUS_OBJECTDESC 構造体でクラス ID が渡されませんでした。 |
| 0x88781182 (DMUS_E_LOADER_FAILEDOPEN) | ファイルのオープンに失敗しました。 |
| 0x88781183 (DMUS_E_LOADER_FORMATNOTSUPPORTED) | データフォーマットがサポートされていないため、オブジェクトをロードできませんでした。 |
| 0x88781184 (DMUS_E_LOADER_FAILEDCREATE) | オブジェクトが見つからないか、または作成できませんでした。 |