Microsoft DirectX 8.0 (C++)

IDirectMusicLoader8::LoadObjectFromFile

指定されたオブジェクトをファイルから取得し、目的のインターフェイスを返す。このメソッドは、オブジェクトがファイル内にあるときに、IDirectMusicLoader8::GetObject の代わりに使用することができる。

HRESULT LoadObjectFromFile(
  REFGUID rguidClassID, 
  REFIID iidInterfaceID, 
  WCHAR *pwzFilePath, 
  void ** ppObject
);

パラメータ

rguidClassID
オブジェクト クラスの一意の識別子。標準的なローダブル クラスのリストについては、「IDirectMusicLoader8」を参照すること。
iidInterfaceID
インターフェイスの一意の識別子。Dmusici.h で定義されている IID を参照すること。標準的なインターフェイスはすべて、"IID_" とインターフェイスの名前で構成される定義済みの識別子を持つ。たとえば、IDirectMusicTrack8 の識別子は IID_IDirectMusicTrack8 である。
pwzFilePath
オブジェクトを保持するファイルの名前。フル パスか、または検索ディレクトリからの相対パスを使用できる。
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::GetObjectIDirectMusicLoader8::SetSearchDirectory