Microsoft DirectX 8.0 (C++) |
オブジェクト ファイルを探すための検索パスを設定する。1 つのオブジェクト タイプ、またはすべてのファイルに対する検索パスを設定できる。
HRESULT SetSearchDirectory( REFGUID rguidClass, WCHAR* pwszPath, BOOL fClear );
成功した場合は S_OK を返す。検索ディレクトリが既に pwszPath に設定されている場合は S_FALSE を返す。
失敗した場合は、次のいずれかのエラー値を返す。
E_OUTOFMEMORY |
E_POINTER |
DMUS_E_LOADER_BADPATH |
検索パスを設定した後、ローダーはファイル名を使ってオブジェクトをロードするときに、フル パス名を必要としない。この結果、オブジェクトはフル パスを把握していなくてもほかのオブジェクトを参照できる。
このメソッドが呼び出されたときに、DMUS_OBJECTDESC 構造体の dwValidData メンバに DMUS_OBJ_FULLPATH フラグが設定されていなければ、ローダーは wszFileName メンバがファイル名のみ、または検索ディレクトリからの相対パスを保持していることを想定する。
ヘッダー : dmusici.h で宣言。