IWICBitmapCodecInfo::GetFileExtensions 메서드(wincodec.h)

코덱과 연결된 파일 이름 확장명 목록을 쉼표로 구분하여 검색합니다.

구문

HRESULT GetFileExtensions(
  [in]      UINT  cchFileExtensions,
  [in, out] WCHAR *wzFileExtensions,
  [in, out] UINT  *pcchActual
);

매개 변수

[in] cchFileExtensions

형식: UINT

파일 이름 확장명 버퍼의 크기입니다. 첫 번째 호출에서 를 사용하여 0 필요한 버퍼 크기를 확인합니다.

[in, out] wzFileExtensions

형식: WCHAR*

코덱과 연결된 파일 이름 확장명 목록을 쉼표로 구분하여 받습니다. 첫 번째 호출에서 를 사용하여 NULL 필요한 버퍼 크기를 확인합니다.

[in, out] pcchActual

형식: UINT*

코덱과 연결된 모든 파일 이름 확장명을 검색하는 데 필요한 실제 버퍼 크기입니다.

반환 값

형식: HRESULT

메서드가 성공하면 S_OK를 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

이미지 인코더의 기본 확장은 반환된 확장 목록의 첫 번째 항목입니다.

이 메서드의 사용 패턴은 두 가지 호출 프로세스입니다. 첫 번째 호출은 cchFileExtensions를 로 설정하고 wzFileExtensions를 로 설정하여 전체 색 관리 버전 번호를 검색하는 NULL0 데 필요한 버퍼 크기를 검색합니다. 이 호출은 pcchActual 을 필요한 버퍼 크기로 설정합니다. 필요한 버퍼 크기가 결정되면 cchFileExtensions 가 버퍼 크기로 설정되고 wzFileExtensions 가 적절한 크기의 버퍼로 설정된 두 번째 GetFileExtensions 호출은 픽셀 형식을 검색합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	WINDOWS XP SP2, Windows Vista [데스크톱 앱 | UWP 앱]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱 | UWP 앱]
대상 플랫폼	Windows
헤더	wincodec.h
라이브러리	Windowscodecs.lib