Função D3DXLoadMeshFromXResource
Carrega uma malha de um recurso.
Sintaxe
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
);
Parâmetros
-
Módulo [in]
-
Tipo: HMODULE
Manipule para o módulo em que o recurso está localizado ou NULL para o módulo associado à imagem que o sistema operacional usou para criar o processo atual. Consulte Observações.
-
Nome [in]
-
Tipo: LPCSTR
Ponteiro para uma cadeia de caracteres que especifica o recurso do qual criar a malha. Consulte Observações.
-
Digite [in]
-
Tipo: LPCSTR
Ponteiro para uma cadeia de caracteres que especifica o tipo de recurso. Consulte Observações.
-
Opções [in]
-
Tipo: DWORD
Combinação de um ou mais sinalizadores da enumeração D3DXMESH que especificam opções de criação para a malha.
-
pD3DDevice [in]
-
Tipo: LPDIRECT3DDEVICE9
Ponteiro para uma interface IDirect3DDevice9 , o objeto do dispositivo associado à malha.
-
ppAdjacency [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 três DWORDs por rosto que especificam os três vizinhos para cada rosto na malha.
-
ppMaterials [out]
-
Tipo: LPD3DXBUFFER*
Endereço de um ponteiro para uma interface ID3DXBuffer . Quando esse método retorna, esse parâmetro é preenchido com uma matriz de estruturas D3DXMATERIAL , contendo informações salvas no arquivo DirectX.
-
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 [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 valores: D3DERR_INVALIDCALL, E_OUTOFMEMORY.
Comentários
Consulte FindResource para saber mais sobre os parâmetros Module, Name e Type.
Todas as malhas do arquivo serão recolhidas em uma malha de saída. Se o arquivo contiver uma hierarquia de quadros, todas as transformações serão aplicadas à malha.
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