GetWinMetaFileBits 함수(wingdi.h)
GetWinMetaFileBits 함수는 메타파일의 고급 형식 레코드를 Windows 형식 레코드로 변환하고 변환된 레코드를 지정된 버퍼에 저장합니다.
구문
UINT GetWinMetaFileBits(
[in] HENHMETAFILE hemf,
[in] UINT cbData16,
[out] LPBYTE pData16,
[in] INT iMapMode,
[in] HDC hdcRef
);
매개 변수
[in] hemf
향상된 메타파일의 핸들입니다.
[in] cbData16
변환된 레코드를 복사할 버퍼의 크기(바이트)입니다.
[out] pData16
변환된 레코드를 수신하는 버퍼에 대한 포인터입니다. lpbBuffer가 NULL인 경우 GetWinMetaFileBits는 변환된 메타파일 레코드를 저장하는 데 필요한 바이트 수를 반환합니다.
[in] iMapMode
변환된 메타파일에서 사용할 매핑 모드입니다.
[in] hdcRef
참조 디바이스 컨텍스트에 대한 핸들입니다.
반환 값
함수가 성공하고 버퍼 포인터가 NULL이면 반환 값은 변환된 레코드를 저장하는 데 필요한 바이트 수입니다. 함수가 성공하고 버퍼 포인터가 유효한 포인터이면 반환 값은 메타파일 데이터의 크기(바이트)입니다.
함수가 실패하면 반환 값은 0입니다.
설명
이 함수는 이전 형식을 인식하는 애플리케이션에 그림을 표시할 수 있도록 향상된 메타파일을 Windows 형식 메타파일로 변환합니다.
시스템은 참조 디바이스 컨텍스트를 사용하여 변환된 메타파일의 해상도를 결정합니다.
GetWinMetaFileBits 함수는 향상된 메타파일 핸들을 무효화하지 않습니다. 애플리케이션은 DeleteEnhMetaFile 함수를 호출하여 더 이상 필요하지 않은 경우 핸들을 해제해야 합니다.
확장 가능한 Windows 형식 메타파일을 만들려면 fnMapMode 매개 변수로 MM_ANISOTROPIC 지정합니다.
메타파일 그림의 왼쪽 위 모서리는 항상 참조 디바이스의 원본에 매핑됩니다.
요구 사항
| 지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 대상 플랫폼 | Windows |
| 헤더 | wingdi.h(Windows.h 포함) |
| 라이브러리 | Gdi32.lib |
| DLL | Gdi32.dll |