Função D3DXLoadMeshFromXof
Carrega uma malha de um objeto ID3DXFileData .
Sintaxe
HRESULT D3DXLoadMeshFromXof(
_In_ LPD3DXFILEDATA pxofMesh,
_Out_ DWORD Options,
_In_ LPDIRECT3DDEVICE9 pDevice,
_Out_ LPD3DXBUFFER *ppAdjacency,
_Inout_ LPD3DXBUFFER *ppMaterials,
_Out_ LPD3DXBUFFER *ppEffectInstances,
_Inout_ DWORD *pNumMaterials,
_Out_ LPD3DXMESH *ppMesh
);
Parâmetros
-
pxofMesh [in]
-
Tipo: LPD3DXFILEDATA
Ponteiro para uma interface ID3DXFileData , representando o objeto de dados de arquivo a ser carregado.
-
Opções [out]
-
Tipo: DWORD
Combinação de um ou mais sinalizadores da enumeração D3DXMESH , especificando opções de criação para a malha.
-
pDevice [in]
-
Tipo: LPDIRECT3DDEVICE9
Ponteiro para uma interface IDirect3DDevice9 , o objeto do dispositivo associado à malha.
-
ppAdjacency [out]
-
Tipo: LPD3DXBUFFER*
Ponteiro para um buffer que contém dados de adjacência. Os dados de adjacência contêm uma matriz de três DWORDs por rosto que especificam os três vizinhos para cada rosto na malha. Para obter mais informações sobre como acessar o buffer, consulte ID3DXBuffer.
-
ppMaterials [in, out]
-
Tipo: LPD3DXBUFFER*
Endereço de um ponteiro para uma interface ID3DXBuffer . Quando o método retorna, esse parâmetro é preenchido com uma matriz de estruturas D3DXMATERIAL .
-
ppEffectInstances [out]
-
Tipo: LPD3DXBUFFER*
Ponteiro para um buffer que contém uma matriz de instâncias de efeito, uma por grupo de atributos na malha retornada. Uma instância de efeito é uma instância específica das informações de estado usadas para inicializar um efeito. Consulte D3DXEFFECTINSTANCE. Para obter mais informações sobre como acessar o buffer, consulte ID3DXBuffer.
-
pNumMaterials [in, out]
-
Tipo: DWORD*
Ponteiro para o número de estruturas D3DXMATERIAL na matriz ppMaterials , quando o método retorna.
-
ppMesh [out]
-
Tipo: LPD3DXMESH*
Endereço de um ponteiro para uma interface ID3DXMesh , representando a malha carregada.
Valor retornado
Tipo: HRESULT
Se a função for bem-sucedida, o valor retornado será D3D_OK. Se a função falhar, o valor retornado poderá ser um dos seguintes: D3DERR_INVALIDCALL, D3DXERR_INVALIDDATA E_OUTOFMEMORY.
Comentários
Para arquivos de malha que não contêm informações de instância de efeito, instâncias de efeito padrão serão geradas a partir das informações de material no arquivo .x. Uma instância de efeito padrão terá valores padrão que correspondem aos membros da estrutura D3DMATERIAL9 .
O nome de textura padrão também é preenchido, mas é tratado de forma diferente. O nome será Texture0@Name, que corresponde a uma variável de efeito pelo nome de "Texture0" com uma anotação chamada "Name". Isso conterá o nome do arquivo de cadeia de caracteres para a textura.
Requisitos
Requisito | Valor |
---|---|
parâmetro |
|
Biblioteca |
|
Confira também