Función D3DXLoadMeshFromXof

Carga una malla desde un objeto ID3DXFileData .

Sintaxis

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

Puntero a una interfaz ID3DXFileData , que representa el objeto de datos de archivo que se va a cargar.

Opciones [out]

Tipo: DWORD

Combinación de una o varias marcas de la enumeración D3DXMESH , especificando opciones de creación para la malla.

pDevice [in]

Tipo: LPDIRECT3DDEVICE9

Puntero a una interfaz IDirect3DDevice9 , el objeto de dispositivo asociado a la malla.

ppAdjacency [out]

Tipo: LPD3DXBUFFER*

Puntero a un búfer que contiene datos de adyacencia. Los datos de adyacencia contienen una matriz de tres DWORD por cara que especifican los tres vecinos para cada cara de la malla. Para obtener más información sobre el acceso al búfer, vea ID3DXBuffer.

ppMaterials [in, out]

Tipo: LPD3DXBUFFER*

Dirección de un puntero a una interfaz ID3DXBuffer . Cuando se devuelve el método, este parámetro se rellena con una matriz de estructuras D3DXMATERIAL .

ppEffectInstances [out]

Tipo: LPD3DXBUFFER*

Puntero a un búfer que contiene una matriz de instancias de efecto, una por grupo de atributos de la malla devuelta. Una instancia de efecto es una instancia determinada de información de estado utilizada para inicializar un efecto. Consulte D3DXEFFECTINSTANCE. Para obtener más información sobre el acceso al búfer, vea ID3DXBuffer.

pNumMaterials [in, out]

Tipo: DWORD*

Puntero al número de estructuras D3DXMATERIAL de la matriz ppMaterials , cuando el método devuelve.

ppMesh [out]

Tipo: LPD3DXMESH*

Dirección de un puntero a una interfaz ID3DXMesh , que representa la malla cargada.

Valor devuelto

Tipo: HRESULT

Si la función se realiza correctamente, el valor devuelto se D3D_OK. Si se produce un error en la función, el valor devuelto puede ser uno de los siguientes: D3DERR_INVALIDCALL, D3DXERR_INVALIDDATA, E_OUTOFMEMORY.

Comentarios

En el caso de los archivos de malla que no contienen información de instancia de efecto, las instancias de efecto predeterminadas se generarán a partir de la información del material en el archivo .x. Una instancia de efecto predeterminada tendrá valores predeterminados que corresponden a los miembros de la estructura D3DMATERIAL9 .

El nombre de textura predeterminado también se rellena, pero se controla de forma diferente. El nombre será Texture0@Name, que corresponde a una variable de efecto por el nombre de "Texture0" con una anotación denominada "Name". Esto contendrá el nombre del archivo de cadena para la textura.

Requisitos

Requisito	Value
Encabezado	D3DX9Mesh.h
Biblioteca	D3dx9.lib

Consulte también

Funciones de malla

D3DXEFFECTDEFAULT

D3DXEFFECTINSTANCE