Platform SDK: DirectX

IDirectMusicObject::ParseDescriptor

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

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

HRESULT ParseDescriptor(
  LPSTREAM pStream, 
  LPDMUS_OBJECTDESC pDesc
);

パラメータ

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

戻り値

成功すれば S_OK を返す。

失敗すれば次のエラー値のいずれかを返す。

DMUS_E_CHUNKNOTFOUND
DMUS_E_INVALID_BAND
DMUS_E_INVALIDFILE
DMUS_E_NOTADLSCOL
E_POINTER

動作環境

  Windows NT/2000 : Windows 2000 が必要。
  Windows 95/98 : Windows 95 以降が必要。Windows 95 用に再配布可能な形で使用可能。
  ヘッダー : dmusici.h で宣言。

参照

IDirectMusicObject::SetDescriptor