Platform SDK: DirectX |
IDirectMusicLoader::SetSearchDirectory メソッドは、オブジェクトファイルを検索するための検索パスを設定する。1 つのオブジェクト タイプ、またはすべてのファイルに対する検索パスを設定できる。
HRESULT SetSearchDirectory( REFGUID rguidClass, WCHAR* pwszPath, BOOL fClear );
成功すれば S_OK を返す。検索ディレクトリが既に pwszPath に設定されている場合は S_FALSE を返す。
失敗すれば次のエラー値のいずれかを返す。
E_OUTOFMEMORY |
E_POINTER |
DMUS_E_LOADER_BADPATH |
検索パスを設定した後、ローダーはファイル名を使ってオブジェクトをロードするときに、フルパス名を必要としない。この結果、オブジェクトはフル パスを把握していなくても他のオブジェクトを参照できる。
Windows NT/2000 : Windows 2000 が必要。
Windows 95/98 : Windows 95 以降が必要。Windows 95 用に再配布可能な形で使用可能。
ヘッダー : dmusici.h で宣言。