Microsoft DirectX 8.0 (C++) |
IDirectMusicObject8::ParseDescriptor メソッドはファイル ストリームを受け取り、DMUS_OBJECTDESC 構造体に保存できるデータをファイルから検索する。dwValidData 内で、供給されたメンバに対して適切なフラグを割り当てる。
このメソッドは、主にローダーがディレクトリでオブジェクトを検索する際に使われるものであり、通常はアプリケーションが直接利用することはない。ただし、アプリケーションが DirectMusic 内にオブジェクト タイプを実装する場合、そのアプリケーションはこのメソッドをサポートすべきである。
HRESULT ParseDescriptor( LPSTREAM pStream, LPDMUS_OBJECTDESC pDesc );
成功した場合は S_OK または DMUS_S_GARBAGE_COLLECTED を返す。「ガベージ コレクション」を参照すること。
失敗した場合は、次のいずれかのエラー値を返す。
DMUS_E_CHUNKNOTFOUND |
DMUS_E_INVALID_BAND |
DMUS_E_INVALIDFILE |
DMUS_E_NOTADLSCOL |
E_FAIL |
E_OUTOFMEMORY |
E_POINTER |
ヘッダー : dmusici.h で宣言。