Microsoft DirectX 8.0 (C++) |
指定されたオブジェクトをファイルから取得し、目的のインターフェイスを返す。このメソッドは、オブジェクトがファイル内にあるときに、IDirectMusicLoader8::GetObject の代わりに使用することができる。
HRESULT LoadObjectFromFile( REFGUID rguidClassID, REFIID iidInterfaceID, WCHAR *pwzFilePath, void ** ppObject );
成功した場合は S_OK または DMUS_S_PARTIALLOAD を返す。
失敗した場合は、次のいずれかのエラー値を返す。
E_FAIL |
E_INVALIDARG |
E_OUTOFMEMORY |
E_POINTER |
DMUS_E_LOADER_NOCLASSID |
DMUS_E_LOADER_FAILEDOPEN |
DMUS_E_LOADER_FAILEDCREATE |
DMUS_E_LOADER_FORMATNOTSUPPORTED |
REGDB_E_CLASSNOTREG |
セグメントで参照されるスタイルなど、参照されるオブジェクトが見つからない場合は、DMUS_S_PARTIALLOAD が返される。スタイルが名前で参照され、そのスタイルに対して IDirectMusicLoader8::ScanDirectory が呼び出されていない場合、ローダーはスタイルを見つけることができない場合がある。デフォルトの音色コレクション ファイルである Gm.dls が利用できない場合にも、DMUS_S_PARTIALLOAD が返されることがある。
ヘッダー : dmusici.h で宣言。
IDirectMusicLoader8::GetObject、IDirectMusicLoader8::SetSearchDirectory