IDirectMusicLoader

IDirectMusicLoader::GetObject

指定された DirectMusic オブジェクトをファイルまたはリソースから取り出して、指定されたインターフェースを返します。

HRESULT GetObject(
    LPDMUS_OBJECTDESC pDesk,
    REFIID            riid,
    LPVOID           *ppv
);

メソッドのインデックス: 3

パラメータ

pDesk

取り出すオブジェクトの情報を格納した DMUS_OBJECTDESC 構造体のアドレスを指定します。

riid

取得するインターフェース ID への参照を指定します。

ppv

インターフェースポインタを格納する変数のアドレスを指定します。

戻り値

成功すると 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)

オブジェクトが見つからないか、または作成できませんでした。