GetWinMetaFileBits 함수(wingdi.h)

아티클
03/08/2023

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