Функция D3DXLoadVolumeFromMemory
Загружает том из памяти.
Синтаксис
HRESULT D3DXLoadVolumeFromMemory(
_In_ LPDIRECT3DVOLUME9 pDestVolume,
_In_ const PALETTEENTRY *pDestPalette,
_In_ const D3DBOX *pDestBox,
_In_ LPCVOID pSrcMemory,
_In_ D3DFORMAT SrcFormat,
_In_ UINT SrcRowPitch,
_In_ UINT SrcSlicePitch,
_In_ const PALETTEENTRY *pSrcPalette,
_In_ const D3DBOX *pSrcBox,
_In_ DWORD Filter,
_In_ D3DCOLOR ColorKey
);
Параметры
-
pDestVolume [in]
-
Тип: LPDIRECT3DVOLUME9
Указатель на интерфейс IDirect3DVolume9 . Указывает целевой том, который получает изображение.
-
pDestPalette [in]
-
Тип: const PALETTEENTRY*
Указатель на структуру PALETTEENTRY , конечную палитру из 256 цветов или NULL.
-
pDestBox [in]
-
Тип: const D3DBOX*
Указатель на структуру D3DBOX . Указывает поле назначения. Присвойте этому параметру значение NULL , чтобы указать весь том.
-
pSrcMemory [in]
-
Тип: LPCVOID
Указатель на левый верхний угол исходного тома в памяти.
-
SrcFormat [in]
-
Тип: D3DFORMAT
Член перечисленного типа D3DFORMAT , формат пикселей исходного тома.
-
SrcRowPitch [in]
-
Тип: UINT
Шаг исходного изображения в байтах. Для форматов DXT (форматов сжатых текстур) это число должно представлять размер одной строки ячеек в байтах.
-
SrcSlicePitch [in]
-
Тип: UINT
Шаг исходного изображения в байтах. Для форматов DXT (форматов сжатых текстур) это число должно представлять размер одного среза ячеек в байтах.
-
pSrcPalette [in]
-
Тип: const PALETTEENTRY*
Указатель на структуру PALETTEENTRY , исходную палитру из 256 цветов или NULL.
-
pSrcBox [вход]
-
Тип: const D3DBOX*
Указатель на структуру D3DBOX . Указывает поле источника. Значение NULL не является допустимым значением для этого параметра.
-
Фильтр [вход]
-
Тип: DWORD
Сочетание одного или нескольких D3DX_FILTER , управляющих фильтрацией изображения. Указание D3DX_DEFAULT для этого параметра эквивалентно указанию D3DX_FILTER_TRIANGLE | D3DX_FILTER_DITHER.
-
ColorKey [in]
-
Тип: D3DCOLOR
Значение D3DCOLOR для замены на прозрачный черный или 0 для отключения цветовой клавиши. Это всегда 32-разрядный цвет ARGB, независимо от формата исходного изображения. Альфа-канал имеет важное значение и обычно должен иметь значение FF для непрозрачных цветовых клавиш. Таким образом, для непрозрачного черного цвета значение будет равно 0xFF000000.
Возвращаемое значение
Тип: HRESULT
Если функция выполняется успешно, возвращаемое значение будет D3D_OK. Если функция завершается сбоем, возвращаемое значение может быть одним из следующих значений: D3DERR_INVALIDCALL D3DXERR_INVALIDDATA.
Комментарии
Запись на поверхности текстуры тома, отличной от нуля, не приведет к обновлению прямоугольника грязное. Если вызывается D3DXLoadVolumeFromMemory и текстура еще не была грязное (это маловероятно в обычных сценариях использования), приложение должно явно вызвать IDirect3DVolumeTexture9::AddDirtyBox для текстуры тома.
Требования
| Требование | Значение |
|---|---|
| Заголовок |
|
| Библиотека |
|
См. также раздел