Функция D3DXLoadMeshFromXof

Загружает сетку из объекта ID3DXFileData .

Синтаксис

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
);

Параметры

pxofMesh [in]

Тип: LPD3DXFILEDATA

Указатель на интерфейс ID3DXFileData , представляющий загружаемый объект данных файла.

Параметры [out]

Тип: DWORD

Сочетание одного или нескольких флагов из перечисления D3DXMESH с указанием параметров создания сетки.

pDevice [in]

Тип: LPDIRECT3DDEVICE9

Указатель на интерфейс IDirect3DDevice9 , объект устройства, связанный с сеткой.

ppAdjacency [out]

Тип: LPD3DXBUFFER*

Указатель на буфер, содержащий данные о соседствах. Данные смежности содержат массив из трех DWORD на каждое лицо, в котором указываются три соседя для каждого лица в сетке. Дополнительные сведения о доступе к буферу см. в разделе ID3DXBuffer.

ppMaterials [in, out]

Тип: LPD3DXBUFFER*

Адрес указателя на интерфейс ID3DXBuffer . При возврате метода этот параметр заполняется массивом структур D3DXMATERIAL .

ppEffectInstances [out]

Тип: LPD3DXBUFFER*

Указатель на буфер, содержащий массив экземпляров эффекта, по одному на группу атрибутов в возвращаемой сетке. Экземпляр эффекта — это конкретный экземпляр сведений о состоянии, используемых для инициализации эффекта. См . раздел D3DXEFFECTINSTANCE. Дополнительные сведения о доступе к буферу см. в разделе ID3DXBuffer.

pNumMaterials [in, out]

Тип: DWORD*

Указатель на количество структур D3DXMATERIAL в массиве ppMaterials при возврате метода.

ppMesh [out]

Тип: LPD3DXMESH*

Адрес указателя на интерфейс ID3DXMesh , представляющий загруженную сетку.

Возвращаемое значение

Тип: HRESULT

Если функция выполняется успешно, возвращаемое значение будет D3D_OK. Если функция завершается сбоем, возвращаемое значение может быть одним из следующих: D3DERR_INVALIDCALL, D3DXERR_INVALIDDATA E_OUTOFMEMORY.

Комментарии

Для файлов сетки, которые не содержат сведения об экземпляре эффекта, экземпляры эффектов по умолчанию создаются из сведений о материалах в X-файле. Экземпляр эффекта по умолчанию будет иметь значения по умолчанию, соответствующие членам структуры D3DMATERIAL9 .

Имя текстуры по умолчанию также заполняется, но обрабатывается иначе. Имя будет Texture0@Name, которое соответствует переменной эффекта с именем Texture0 с заметкой "Name". Он будет содержать строковое имя файла текстуры.

Требования

См. также раздел

Функции сетки

D3DXEFFECTDEFAULT

D3DXEFFECTINSTANCE