D3DXLoadPatchMeshFromXof 函数

从 ID3DXFileData 对象加载修补网格。

语法

HRESULT D3DXLoadPatchMeshFromXof(
  _In_  LPD3DXFILEDATA    pxofMesh,
  _In_  DWORD             Options,
  _In_  LPDIRECT3DDEVICE9 pD3DDevice,
  _Out_ LPD3DXBUFFER      *ppMaterials,
  _Out_ LPD3DXBUFFER      *ppEffectInstances,
  _Out_ PDWORD            pNumMaterials,
  _Out_ LPD3DXPATCHMESH   *ppMesh
);

参数

pxofMesh [in]

类型： LPD3DXFILEDATA

指向 ID3DXFileData 接口的指针，表示要加载的文件数据对象。

选项 [in]

类型： DWORD

一个或多个 D3DXMESH 标志的组合，指定网格的创建选项。

pD3DDevice [in]

类型： LPDIRECT3DDEVICE9

指向创建网格的设备的指针。

ppMaterials [out]

类型： LPD3DXBUFFER*

网格中包含的材料的数组。 每个材料都由 ID3DXBuffer 接口编制索引。

ppEffectInstances [out]

类型： LPD3DXBUFFER*

指向包含效果实例数组的缓冲区的指针，返回的网格中每个属性组一个。 效果实例是用于初始化效果的状态信息的特定实例。 请参阅 D3DXEFFECTINSTANCE。 有关访问缓冲区的详细信息，请参阅 ID3DXBuffer。

pNumMaterials [out]

类型： PDWORD

包含网格中材料数的指针。

ppMesh [out]

类型： LPD3DXPATCHMESH*

指向 ID3DXPatchMesh 接口的指针的地址，表示加载的网格。

返回值

类型： HRESULT

如果函数成功，则返回值D3D_OK。 如果函数失败，则返回值可以是下列值之一：D3DERR_INVALIDCALL、D3DXERR_INVALIDDATA、E_OUTOFMEMORY。

备注

对于不包含效果实例信息的网格文件，将从 .x 文件中的材料信息生成默认效果实例。 默认效果实例将具有对应于 D3DMATERIAL9 结构成员的默认值。

默认纹理名称也已填充，但处理方式不同。 名称将Texture0@Name，该名称对应于名为“Texture0”且带有名为“Name”的批注的效果变量。这将包含纹理的字符串文件名。

要求

要求	值
标头	D3DX9Mesh.h
库	D3dx9.lib

另请参阅

网格函数

D3DXEFFECTDEFAULT

D3DXEFFECTINSTANCE