Função D3DXSaveVolumeToFile
Salva um volume em um arquivo no disco.
Sintaxe
HRESULT D3DXSaveVolumeToFile(
_In_ LPCTSTR pDestFile,
_In_ D3DXIMAGE_FILEFORMAT DestFormat,
_In_ LPDIRECT3DVOLUME9 pSrcVolume,
_In_ const PALETTEENTRY *pSrcPalette,
_In_ const D3DBOX *pSrcBox
);
Parâmetros
-
pDestFile [in]
-
Tipo: LPCTSTR
Ponteiro para uma cadeia de caracteres que especifica o nome do arquivo da imagem de destino. Se as configurações do compilador exigirem Unicode, o tipo de dados LPCTSTR será resolvido para LPCWSTR. Caso contrário, o tipo de dados de cadeia de caracteres será resolvido para LPCSTR. Consulte Observações.
-
DestFormat [in]
-
Tipo: D3DXIMAGE_FILEFORMAT
D3DXIMAGE_FILEFORMAT especificando o formato de arquivo a ser usado ao salvar. Essa função dá suporte ao salvamento em todos os formatos de D3DXIMAGE_FILEFORMAT , exceto Pixmap Portátil (.ppm) e Adaptador gráfico Targa/Truevision (.tga).
-
pSrcVolume [in]
-
Tipo: LPDIRECT3DVOLUME9
Ponteiro para a interface IDirect3DVolume9 que contém a imagem a ser salva.
-
pSrcPalette [in]
-
Tipo: const PALETTEENTRY*
Ponteiro para uma estrutura PALETTEENTRY que contém uma paleta de 256 cores. Este parâmetro pode ser NULL.
-
pSrcBox [in]
-
Tipo: const D3DBOX*
Ponteiro para uma estrutura D3DBOX . Especifica a caixa de origem. Defina esse parâmetro como NULL para especificar todo o volume.
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 o seguinte: D3DERR_INVALIDCALL
Comentários
A configuração do compilador também determina a versão da função. Se Unicode for definido, a chamada de função será resolvida para D3DXSaveVolumeToFileW. Caso contrário, a chamada de função será resolvida para >D3DXSaveVolumeToFileA porque as cadeias de caracteres ANSI estão sendo usadas.
Essa função manipula a conversão de e para formatos de textura compactadas.
Se o volume for nãodinâmico (devido a um parâmetro de uso definido como 0 na criação) e localizado na memória de vídeo (o pool de memória definido como D3DPOOL_DEFAULT), D3DXSaveTextureToFile falhará porque o D3DX não pode bloquear volumes nãodinâmicos localizados na memória de vídeo.
Requisitos
| Requisito | Valor |
|---|---|
| parâmetro |
|
| Biblioteca |
|
Confira também