D3DXLoadMeshFromXResource 関数

  • [アーティクル]

リソースからメッシュを読み込みます。

構文

HRESULT D3DXLoadMeshFromXResource(
  _In_  HMODULE           Module,
  _In_  LPCSTR            Name,
  _In_  LPCSTR            Type,
  _In_  DWORD             Options,
  _In_  LPDIRECT3DDEVICE9 pD3DDevice,
  _Out_ LPD3DXBUFFER      *ppAdjacency,
  _Out_ LPD3DXBUFFER      *ppMaterials,
  _Out_ LPD3DXBUFFER      *ppEffectInstances,
  _Out_ DWORD             *pNumMaterials,
  _Out_ LPD3DXMESH        *ppMesh
);

パラメーター

モジュール [入力]

種類: HMODULE

リソースが配置されているモジュールを処理するか、現在のプロセスの作成に使用されるオペレーティング システムのイメージに関連付けられているモジュールの NULL を 処理します。 「解説」を参照してください。

Name [in]

種類: LPCSTR

メッシュを作成するリソースを指定する文字列へのポインター。 「解説」を参照してください。

「in」と入力します

種類: LPCSTR

リソースの種類を指定する文字列へのポインター。 「解説」を参照してください。

オプション [in]

種類: DWORD

メッシュの作成オプションを指定する D3DXMESH 列挙からの 1 つ以上のフラグの組み合わせ。

pD3DDevice [in]

種類: LPDIRECT3DDEVICE9

メッシュに関連付けられているデバイス オブジェクトである IDirect3DDevice9 インターフェイスへのポインター。

ppAdjacency [out]

種類: LPD3DXBUFFER*

ID3DXBuffer インターフェイスへのポインターのアドレス。 メソッドが戻ると、このパラメーターには、メッシュ内の各面の 3 つのネイバーを指定する 1 面あたり 3 つの DWORD の配列が格納されます。

ppMaterials [out]

種類: LPD3DXBUFFER*

ID3DXBuffer インターフェイスへのポインターのアドレス。 このメソッドが戻ると、このパラメーターには、DirectX ファイルに保存されている情報を含む D3DXMATERIAL 構造体の配列が入力されます。

ppEffectInstances [out]

種類: LPD3DXBUFFER*

返されたメッシュ内の属性グループごとに 1 つずつ、効果インスタンスの配列を含むバッファーへのポインター。 効果インスタンスは、効果を初期化するために使用される状態情報の特定のインスタンスです。 「D3DXEFFECTINSTANCE」を参照してください。 バッファーへのアクセスの詳細については、「 ID3DXBuffer」を参照してください。

pNumMaterials [out]

種類: DWORD*

メソッドが返されるときに、ppMaterials 配列内の D3DXMATERIAL 構造体の数へのポインター。

ppMesh [out]

種類: LPD3DXMESH*

読み込まれたメッシュを表す ID3DXMesh インターフェイスへのポインターのアドレス。

戻り値

種類: HRESULT

関数が成功した場合、戻り値はD3D_OK。 関数が失敗した場合、戻り値には次のいずれかの値を指定できます:D3DERR_INVALIDCALL、E_OUTOFMEMORY。

解説

モジュール、名前、型の各パラメーターの詳細については、「 FindResource 」を参照してください。

ファイル内のすべてのメッシュは、1 つの出力メッシュに折りたたまれます。 ファイルにフレーム階層が含まれている場合、すべての変換がメッシュに適用されます。

エフェクト インスタンス情報が含まれていないメッシュ ファイルの場合、既定のエフェクト インスタンスは.x ファイル内のマテリアル情報から生成されます。 既定の効果インスタンスには、 D3DMATERIAL9 構造体のメンバーに対応する既定値があります。

既定のテクスチャ名も入力されますが、処理方法は異なります。 名前はTexture0@Nameされます。これは、"Name" という注釈を持つ "Texture0" という名前の効果変数に対応します。これには、テクスチャの文字列ファイル名が含まれます。

要件

要件 値
ヘッダー
D3DX9Mesh.h
ライブラリ
D3dx9.lib

関連項目

メッシュ関数

D3DXEFFECTDEFAULT

D3DXEFFECTINSTANCE