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 저장할 때 사용할 파일 형식을 지정합니다. 이 함수는 이식 가능한 Pixmap(.ppm) 및 Targa/Truevision 그래픽 어댑터(.tga)를 제외한 모든 D3DXIMAGE_FILEFORMAT 형식에 대한 저장을 지원합니다.
-
pSrcVolume [in]
-
저장할 이미지를 포함하는 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 이 실패합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 헤더 |
|
| 라이브러리 |
|
추가 정보