Função D3DXLoadSurfaceFromMemory
Carrega uma superfície da memória.
Sintaxe
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
);
Parâmetros
-
pDestSurface [in]
-
Tipo: LPDIRECT3DSURFACE9
Ponteiro para uma interface IDirect3DSurface9 . Especifica a superfície de destino, que recebe a imagem.
-
pDestPalette [in]
-
Tipo: const PALETTEENTRY*
Ponteiro para uma estrutura PALETTEENTRY , a paleta de destino de 256 cores ou NULL.
-
pDestRect [in]
-
Tipo: const RECT*
Ponteiro para uma estrutura RECT . Especifica o retângulo de destino. Defina esse parâmetro como NULL para especificar toda a superfície.
-
pSrcMemory [in]
-
Tipo: LPCVOID
Ponteiro para o canto superior esquerdo da imagem de origem na memória.
-
SrcFormat [in]
-
Tipo: D3DFORMAT
Membro do tipo enumerado D3DFORMAT , o formato de pixel da imagem de origem.
-
SrcPitch [in]
-
Tipo: UINT
Pitch da imagem de origem, em bytes. Para formatos DXT, esse número deve representar a largura de uma linha de células, em bytes.
-
pSrcPalette [in]
-
Tipo: const PALETTEENTRY*
Ponteiro para uma estrutura PALETTEENTRY , a paleta de origem de 256 cores ou NULL.
-
pSrcRect [in]
-
Tipo: const RECT*
Ponteiro para uma estrutura RECT . Especifica as dimensões da imagem de origem na memória. Esse valor não pode ser NULL.
-
Filtrar [in]
-
Tipo: DWORD
Combinação de uma ou mais D3DX_FILTER controlar como a imagem é filtrada. Especificar D3DX_DEFAULT para esse parâmetro é o equivalente a especificar D3DX_FILTER_TRIANGLE | D3DX_FILTER_DITHER.
-
ColorKey [in]
-
Tipo: D3DCOLOR
Valor D3DCOLOR a ser substituído por preto transparente ou 0 para desabilitar a colorkey. Essa é sempre uma cor ARGB de 32 bits, independente do formato de imagem de origem. Alfa é significativo e geralmente deve ser definido como FF para chaves de cor opacas. Assim, para preto opaco, o valor seria igual a 0xFF000000.
Valor retornado
Tipo: HRESULT
Se a função for bem-sucedida, o valor retornado será D3D_OK. Se a função falhar, o valor retornado poderá ser um dos seguintes valores: D3DERR_INVALIDCALL, D3DXERR_INVALIDDATA.
Comentários
Essa função manipula a conversão de e para formatos de textura compactadas.
Gravar em uma superfície sem nível zero não fará com que o retângulo sujo seja atualizado. Se D3DXLoadSurfaceFromMemory for chamado e a superfície ainda não estiver sujo (isso é improvável em cenários de uso normais), o aplicativo precisará chamar explicitamente AddDirtyRect na superfície.
Requisitos
| Requisito | Valor |
|---|---|
| parâmetro |
|
| Biblioteca |
|
Confira também