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]
-
メッシュに関連付けられているデバイス オブジェクトである 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" という名前の効果変数に対応します。これには、テクスチャの文字列ファイル名が含まれます。
要件
| 要件 | 値 |
|---|---|
| ヘッダー |
|
| ライブラリ |
|
関連項目