D3DXSaveSurfaceToFile 함수

  • 아티클

표면에 파일을 저장합니다.

구문

HRESULT D3DXSaveSurfaceToFile(
  _In_       LPCTSTR              pDestFile,
  _In_       D3DXIMAGE_FILEFORMAT DestFormat,
  _In_       LPDIRECT3DSURFACE9   pSrcSurface,
  _In_ const PALETTEENTRY         *pSrcPalette,
  _In_ const RECT                 *pSrcRect
);

매개 변수

pDestFile [in]

형식: LPCTSTR

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

DestFormat [in]

형식: D3DXIMAGE_FILEFORMAT

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

pSrcSurface [in]

형식: LPDIRECT3DSURFACE9

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

pSrcPalette [in]

형식: const PALETTEENTRY*

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

pSrcRect [in]

형식: const RECT*

RECT 구조체에 대한 포인터입니다. 원본 사각형을 지정합니다. 이 매개 변수를 NULL 로 설정하여 전체 이미지를 지정합니다.

반환 값

형식: HRESULT

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

설명

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

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

요구 사항

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

추가 정보

D3DX 9의 텍스처 함수

D3DXSaveTextureToFile

D3DXSaveVolumeToFile