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