IDirectMusicLoader

IDirectMusicLoader8::LoadObjectFromFile

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

HRESULT LoadObjectFromFile(
    REFGUID   rclsid,
    REFIID    riid,
    WCHAR     pwzFilePath,
    LPVOID   *ppv
);

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

パラメータ

rclsid

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

riid

取得するインターフェースのインターフェース ID を格納した GUID 構造体のアドレスを指定します。

pwzFilePath

ファイル名を表すワイド文字列のアドレスを指定します。フルパスまたは、検索ディレクトリからの相対パスを指定します。

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)

クラス ID が渡されませんでした。

0x88781182 (DMUS_E_LOADER_FAILEDOPEN)

ファイルのオープンに失敗しました。

0x88781183 (DMUS_E_LOADER_FORMATNOTSUPPORTED)

データフォーマットがサポートされていないため、オブジェクトをロードできませんでした。

0x88781184 (DMUS_E_LOADER_FAILEDCREATE)

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