D3DXSaveTextureToFile 함수

텍스처를 파일에 저장합니다.

구문

HRESULT D3DXSaveTextureToFile(
  _In_       LPCTSTR                pDestFile,
  _In_       D3DXIMAGE_FILEFORMAT   DestFormat,
  _In_       LPDIRECT3DBASETEXTURE9 pSrcTexture,
  _In_ const PALETTEENTRY           *pSrcPalette
);

매개 변수

pDestFile [in]

형식: LPCTSTR

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

DestFormat [in]

형식: D3DXIMAGE_FILEFORMAT

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

pSrcTexture [in]

형식: LPDIRECT3DBASETEXTURE9

저장할 텍스처를 포함하는 IDirect3DBaseTexture9 인터페이스에 대한 포인터입니다.

pSrcPalette [in]

형식: const PALETTEENTRY*

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

반환 값

형식: HRESULT

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

설명

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

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

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

요구 사항

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

추가 정보

D3DX 9의 텍스처 함수

D3DXSaveSurfaceToFile

D3DXSaveVolumeToFile