Функция D3DXCreateVolumeTextureFromResource
Создает текстуру тома из ресурса.
Синтаксис
HRESULT D3DXCreateVolumeTextureFromResource(
_In_ LPDIRECT3DDEVICE9 pDevice,
_In_ HMODULE hSrcModule,
_In_ LPCTSTR pSrcResource,
_Out_ LPDIRECT3DVOLUMETEXTURE9 *ppVolumeTexture
);
Параметры
-
pDevice [in]
-
Тип: LPDIRECT3DDEVICE9
Указатель на интерфейс IDirect3DDevice9 , представляющий устройство, связанное с текстурой тома.
-
hSrcModule [in]
-
Тип: HMODULE
Дескриптор к модулю, в котором находится ресурс, или значение NULL для модуля, связанного с образом, используемым операционной системой для создания текущего процесса.
-
pSrcResource [in]
-
Тип: LPCTSTR
Указатель на строку, указывающую имя ресурса. Если для параметров компилятора требуется Юникод, тип данных LPCTSTR разрешается в LPCWSTR. В противном случае строковый тип данных разрешается в LPCSTR. См. заметки.
-
ppVolumeTexture [out]
-
Тип: LPDIRECT3DVOLUMETEXTURE9*
Адрес указателя на интерфейс IDirect3DVolumeTexture9 , представляющий созданный объект текстуры.
Возвращаемое значение
Тип: HRESULT
Если функция выполняется успешно, возвращаемое значение будет D3D_OK. В случае сбоя функции возвращается одно из следующих значений: D3DERR_NOTAVAILABLE, D3DERR_OUTOFVIDEOMEMORY, D3DERR_INVALIDCALL, D3DXERR_INVALIDDATA E_OUTOFMEMORY.
Комментарии
Параметр компилятора также определяет версию функции. Если определен Юникод, вызов функции разрешается в D3DXCreateVolumeTextureFromResourceW. В противном случае вызов функции разрешается в D3DXCreateVolumeTextureFromResourceA, так как используются строки ANSI.
Функция эквивалентна D3DXCreateVolumeTextureFromResourceEx(pDevice, hSrcModule, pSrcResource, D3DX_DEFAULT, D3DX_DEFAULT, D3DX_DEFAULT, D3DX_DEFAULT, 0, D3DFMT_UNKNOWN, D3DPOOL_MANAGED, D3DX_DEFAULT, D3DX_DEFAULT, 0, NULL, NULL, ppVolumeTexture).
Загружаемый ресурс должен быть ресурсом, определяемым приложением (RT_RCDATA).
Эта функция поддерживает следующие форматы файлов: .bmp, DDS, DIB, HDR, .jpg, PFM, .png, PPM и TGA. См . D3DXIMAGE_FILEFORMAT.
Обратите внимание, что ресурс, созданный с помощью этой функции при вызове из объекта IDirect3Device9, будет помещен в класс памяти, обозначенный D3DPOOL_MANAGED. При вызове этого метода из объекта IDirect3Device9Ex ресурс будет помещен в класс памяти, обозначенный D3DPOOL_DEFAULT.
Фильтрация автоматически применяется к текстуре, созданной с помощью этого метода. Фильтрация эквивалентна D3DX_FILTER_TRIANGLE | D3DX_FILTER_DITHER в D3DX_FILTER.
Требования
| Требование | Значение |
|---|---|
| Заголовок |
|
| Библиотека |
|
См. также раздел