D3DXSaveVolumeToFile 함수

디스크의 파일에 볼륨을 저장합니다.

구문

HRESULT D3DXSaveVolumeToFile(
  _In_       LPCTSTR              pDestFile,
  _In_       D3DXIMAGE_FILEFORMAT DestFormat,
  _In_       LPDIRECT3DVOLUME9    pSrcVolume,
  _In_ const PALETTEENTRY         *pSrcPalette,
  _In_ const D3DBOX               *pSrcBox
);

매개 변수

pDestFile [in]

형식: LPCTSTR

대상 이미지의 파일 이름을 지정하는 문자열에 대한 포인터입니다. 컴파일러 설정에 유니코드가 필요한 경우 LPCTSTR 데이터 형식이 LPCWSTR로 확인됩니다. 그렇지 않으면 문자열 데이터 형식이 LPCSTR로 확인됩니다. 설명 부분을 참조하세요.

DestFormat [in]

형식: D3DXIMAGE_FILEFORMAT

D3DXIMAGE_FILEFORMAT 저장할 때 사용할 파일 형식을 지정합니다. 이 함수는 이식 가능한 Pixmap(.ppm) 및 Targa/Truevision 그래픽 어댑터(.tga)를 제외한 모든 D3DXIMAGE_FILEFORMAT 형식에 대한 저장을 지원합니다.

pSrcVolume [in]

형식: LPDIRECT3DVOLUME9

저장할 이미지를 포함하는 IDirect3DVolume9 인터페이스에 대한 포인터입니다.

pSrcPalette [in]

형식: const PALETTEENTRY*

색상표가 256개인 PALETTEENTRY 구조체에 대한 포인터입니다. 이 매개 변수는 NULL일 수 있습니다.

pSrcBox [in]

형식: const D3DBOX*

D3DBOX 구조체에 대한 포인터입니다. 원본 상자를 지정합니다. 전체 볼륨을 지정하려면 이 매개 변수를 NULL 로 설정합니다.

반환 값

형식: HRESULT

함수가 성공하면 반환 값이 D3D_OK. 함수가 실패하면 반환 값은 다음과 같습니다. D3DERR_INVALIDCALL

설명

컴파일러 설정은 함수 버전도 결정합니다. 유니코드가 정의되면 함수 호출이 D3DXSaveVolumeToFileW로 확인됩니다. 그렇지 않으면 ANSI 문자열이 사용 중이므로 함수 호출이 D3DXSaveVolumeToFileA로 확인 >됩니다.

이 함수는 압축된 텍스처 형식으로 또는 압축된 텍스처 형식으로의 변환을 처리합니다.

볼륨이 비역학적(생성 시 0으로 설정된 사용 매개 변수로 인해) 비디오 메모리(D3DPOOL_DEFAULT로 설정된 메모리 풀)에 있는 경우 D3DX는 비디오 메모리에 있는 비역학적 볼륨을 잠글 수 없기 때문에 D3DXSaveTextureToFile 이 실패합니다.

요구 사항

요구 사항
헤더
D3dx9tex.h
라이브러리
D3dx9.lib

참고 항목

D3DX 9의 질감 함수

D3DXSaveSurfaceToFile

D3DXSaveTextureToFile

D3DXSaveVolumeToFileInMemory