Função D3DXLoadVolumeFromMemory
Carrega um volume da memória.
Sintaxe
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
);
Parâmetros
-
pDestVolume [in]
-
Tipo: LPDIRECT3DVOLUME9
Ponteiro para uma interface IDirect3DVolume9 . Especifica o volume 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.
-
pDestBox [in]
-
Tipo: const D3DBOX*
Ponteiro para uma estrutura D3DBOX . Especifica a caixa de destino. Defina esse parâmetro como NULL para especificar todo o volume.
-
pSrcMemory [in]
-
Tipo: LPCVOID
Ponteiro para o canto superior esquerdo do volume de origem na memória.
-
SrcFormat [in]
-
Tipo: D3DFORMAT
Membro do tipo enumerado D3DFORMAT , o formato de pixel do volume de origem.
-
SrcRowPitch [in]
-
Tipo: UINT
Pitch da imagem de origem, em bytes. Para formatos DXT (formatos de textura compactadas), esse número deve representar o tamanho de uma linha de células, em bytes.
-
SrcSlicePitch [in]
-
Tipo: UINT
Pitch da imagem de origem, em bytes. Para formatos DXT (formatos de textura compactadas), esse número deve representar o tamanho de uma fatia de células, em bytes.
-
pSrcPalette [in]
-
Tipo: const PALETTEENTRY*
Ponteiro para uma estrutura PALETTEENTRY , a paleta de origem de 256 cores ou NULL.
-
pSrcBox [in]
-
Tipo: const D3DBOX*
Ponteiro para uma estrutura D3DBOX . Especifica a caixa de origem. NULL não é um valor válido para esse parâmetro.
-
Filtrar [in]
-
Tipo: DWORD
Uma 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
Gravar em uma superfície sem nível zero da textura do volume não fará com que o retângulo sujo seja atualizado. Se D3DXLoadVolumeFromMemory for chamado e a textura ainda não tiver sido sujo (isso é improvável em cenários de uso normais), o aplicativo precisará chamar explicitamente IDirect3DVolumeTexture9::AddDirtyBox na textura do volume.
Requisitos
| Requisito | Valor |
|---|---|
| parâmetro |
|
| Biblioteca |
|
Confira também