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를 로 설정하여 전체 색 관리 버전 번호를 검색하는 NULL
0
데 필요한 버퍼 크기를 검색합니다.
이 호출은 pcchActual 을 필요한 버퍼 크기로 설정합니다.
필요한 버퍼 크기가 결정되면 cchFileExtensions 가 버퍼 크기로 설정되고 wzFileExtensions 가 적절한 크기의 버퍼로 설정된 두 번째 GetFileExtensions 호출은 픽셀 형식을 검색합니다.
요구 사항
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 | WINDOWS XP SP2, Windows Vista [데스크톱 앱 | UWP 앱] |
지원되는 최소 서버 | Windows Server 2008 [데스크톱 앱 | UWP 앱] |
대상 플랫폼 | Windows |
헤더 | wincodec.h |
라이브러리 | Windowscodecs.lib |