D3DXSaveSurfaceToFile 함수

표면을 파일에 보존한다.

구문

HRESULT D3DXSaveSurfaceToFile(      

    LPCTSTR pDestFile,
    D3DXIMAGE_FILEFORMAT DestFormat,
    LPDIRECT3DSURFACE9 pSrcSurface,
    const PALETTEENTRY *pSrcPalette,
    const RECT *pSrcRect
);

파라미터

pDestFile

[in] 소스 이미지의 파일명을 지정하는 캐릭터 라인의 포인터. 컴파일러의 설정이 Unicode 를 요구하고 있는 경우, 데이터 타입 LPCTSTR 는 LPCWSTR 가 된다. 그 이외의 경우는, 이 캐릭터 라인의 데이터 타입은 LPCSTR 가 된다. 「주의」를 참조할것.

DestFormat

[in] 보존할 경우에 사용하는 파일 포맷을 지정하는 D3DXIMAGE_FILEFORMAT .

pSrcSurface

[in] 보존하는 이미지를 포함한 IDirect3DSurface9 인터페이스의 포인터.

pSrcPalette

[in] 256 색의 팔레트를 포함한 PALETTEENTRY 구조체의 포인터. 이 파라미터는 NULL 로 해도 괜찮다.

pSrcRect

[in] RECT 구조체의 포인터. 전송원직사각형을 지정한다. 이 파라미터에 NULL 를 설정해, 이미지 전체를 지정한다.

반환값

성공했을 경우는,D3D_OK 를 돌려준다.

실패했을 경우는, 다음의 값을 돌려준다.

D3DERR_INVALIDCALL

메서드의 호출이 무효이다. 예를 들어, 메서드의 파라미터에 무효인 값이 설정되어 있는 경우 등이다.

주의

컴파일러의 설정에 의해 함수의 버전도 정해진다. Unicode 가 정의되고 있는 경우, 이 함수의 호출은 D3DXSaveSurfaceToFileW 가 된다. 그 이외의 경우는 ANSI 캐릭터 라인을 사용하므로, 이 함수의 호출은 D3DXSaveSurfaceToFileA 가 된다.

이 함수가 지원 하고 있는 파일 포맷은,. bmp 및 . dds 이다.

이 함수는, 압축 텍스처 포맷간의 변환을 처리한다.

함수의 정보

헤더	d3dx9tex.h
임포트 라이브러리	d3dx9.lib
최저한의 operating system	Windows 98

참조

D3DXSaveTextureToFile ,D3DXSaveVolumeToFile