Функция D3DXLoadMeshFromXResource
Загружает сетку из ресурса.
Синтаксис
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
);
Параметры
-
Модуль [in]
-
Тип: HMODULE
Дескриптор к модулю, в котором находится ресурс, или значение NULL для модуля, связанного с образом, используемым операционной системой для создания текущего процесса. См. примечания.
-
Имя [in]
-
Тип: LPCSTR
Указатель на строку, указывающую ресурс для создания сетки. См. примечания.
-
Введите [в]
-
Тип: LPCSTR
Указатель на строку, указывающую тип ресурса. См. примечания.
-
Параметры [in]
-
Тип: DWORD
Сочетание одного или нескольких флагов перечисления D3DXMESH , определяющих параметры создания сетки.
-
pD3DDevice [in]
-
Тип: LPDIRECT3DDEVICE9
Указатель на интерфейс IDirect3DDevice9 , объект устройства, связанный с сеткой.
-
ppAdjacency [out]
-
Тип: LPD3DXBUFFER*
Адрес указателя на интерфейс ID3DXBuffer . При возврате метода этот параметр заполняется массивом из трех DWORD на каждое лицо, которое задает трех соседей для каждого лица в сетке.
-
ppMaterials [out]
-
Тип: LPD3DXBUFFER*
Адрес указателя на интерфейс ID3DXBuffer . При возврате этого метода этот параметр заполняется массивом структур D3DXMATERIAL , содержащим сведения, сохраненные в файле DirectX.
-
ppEffectInstances [out]
-
Тип: LPD3DXBUFFER*
Указатель на буфер, содержащий массив экземпляров эффектов, по одному на группу атрибутов в возвращаемой сетке. Экземпляр эффекта — это конкретный экземпляр сведений о состоянии, используемых для инициализации эффекта. См. раздел D3DXEFFECTINSTANCE. Дополнительные сведения о доступе к буферу см. в разделе ID3DXBuffer.
-
pNumMaterials [out]
-
Тип: DWORD*
Указатель на количество структур D3DXMATERIAL в массиве ppMaterials при возврате метода.
-
ppMesh [out]
-
Тип: LPD3DXMESH*
Адрес указателя на интерфейс ID3DXMesh , представляющий загруженную сетку.
Возвращаемое значение
Тип: HRESULT
Если функция выполняется успешно, возвращаемое значение будет D3D_OK. Если функция завершается ошибкой, возвращаемое значение может быть одним из следующих значений: D3DERR_INVALIDCALL E_OUTOFMEMORY.
Комментарии
Дополнительные сведения о параметрах Module, Name и Type см. в разделе FindResource .
Все сетки в файле будут сворачиваться в одну выходную сетку. Если файл содержит иерархию кадров, все преобразования будут применены к сетке.
Для файлов сетки, которые не содержат сведения об экземпляре эффекта, экземпляры эффектов по умолчанию создаются на основе сведений о материале в X-файле. Экземпляр эффекта по умолчанию будет иметь значения по умолчанию, соответствующие членам структуры D3DMATERIAL9 .
Имя текстуры по умолчанию также заполняется, но обрабатывается по-разному. Имя будет Texture0@Name, которое соответствует переменной эффекта с именем Texture0 с заметкой с именем Name. Он будет содержать строковое имя файла текстуры.
Требования
| Требование | Значение |
|---|---|
| Заголовок |
|
| Библиотека |
|
См. также раздел