Microsoft DirectX 8.0 (C++)

IDirectMusicObject8::ParseDescriptor

IDirectMusicObject8::ParseDescriptor メソッドはファイル ストリームを受け取り、DMUS_OBJECTDESC 構造体に保存できるデータをファイルから検索する。dwValidData 内で、供給されたメンバに対して適切なフラグを割り当てる。

このメソッドは、主にローダーがディレクトリでオブジェクトを検索する際に使われるものであり、通常はアプリケーションが直接利用することはない。ただし、アプリケーションが DirectMusic 内にオブジェクト タイプを実装する場合、そのアプリケーションはこのメソッドをサポートすべきである。

HRESULT ParseDescriptor(
  LPSTREAM pStream, 
  LPDMUS_OBJECTDESC pDesc
);

パラメータ

pStream
ファイルのストリーム ソース。
pDesc
ファイルに関するデータを受け取る DMUS_OBJECTDESC 構造体のアドレス。

戻り値

成功した場合は 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 で宣言。

参照

IDirectMusicObject8::SetDescriptor