Microsoft DirectX 8.0 (C++)

IDirectMusicLoader8::SetObject

オブジェクトが、ロード中の別のオブジェクトによって後で参照されるときに、オブジェクトの検索場所をローダーに指示する。次に、オブジェクトに属性を追加することによって、属性を使ってそのオブジェクトを参照できるようにする。概要については、「オブジェクトの設定」を参照すること。

HRESULT SetObject(
  LPDMUS_OBJECTDESC pDesc 
);

パラメータ

pDesc
オブジェクトについて記述する DMUS_OBJECTDESC 構造体のアドレス。エントリ時に、この構造体はオブジェクトに関してアプリケーションが持つあらゆる情報を保持する。戻り値として、この構造体は追加の情報を保持している場合がある。

戻り値

成功した場合は S_OK を返す。

失敗した場合は、次のいずれかのエラー値を返す。

E_FAIL
E_INVALIDARG
E_OUTOFMEMORY
E_POINTER
DMUS_E_LOADER_NOCLASSID
DMUS_E_LOADER_FAILEDOPEN
DMUS_E_LOADER_FAILEDCREATE
DMUS_E_LOADER_FORMATNOTSUPPORTED
REGDB_E_CLASSNOTREG

注意

このメソッドを使って、オブジェクトについて現在有効でない属性を設定できる。たとえば、DMUS_OBJECTDESC 構造体の wszName メンバに値を入力し、MIDI ファイルに基づくセグメントなど、名前のないオブジェクトに内部名を割り当てることができる。ただし、既存属性を変更する目的でこのメソッドを使用することはできない。たとえば、ほとんどのオーサリングされたセグメントは既に名前を持っており、これらの名前をアプリケーションによって変更することはできない。

動作環境

  ヘッダー : dmusici.h で宣言。

参照

IDirectMusicLoader8::GetObject