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]
-
指向创建网格的设备的指针。
-
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”的批注的效果变量。这将包含纹理的字符串文件名。
要求
要求 | 值 |
---|---|
标头 |
|
库 |
|
另请参阅