GetMetaFileBitsEx 함수(wingdi.h)

GetMetaFileBitsEx 함수는 Windows 형식 메타파일의 내용을 검색하고 지정된 버퍼에 복사합니다.

참고 이 함수는 Windows 형식 메타파일과의 호환성을 위해서만 제공됩니다. 향상된 형식 메타파일은 뛰어난 기능을 제공하며 새 애플리케이션에 권장됩니다. 고급 형식 메타파일의 해당 함수는 GetEnhMetaFileBits입니다.

구문

UINT GetMetaFileBitsEx(
  [in]  HMETAFILE hMF,
  [in]  UINT      cbBuffer,
  [out] LPVOID    lpData
);

[in] hMF

Windows 형식 메타파일의 핸들입니다.

[in] cbBuffer

데이터를 수신할 버퍼의 크기(바이트)입니다.

[out] lpData

메타파일 데이터를 수신하는 버퍼에 대한 포인터입니다. 버퍼는 데이터를 포함하기에 충분히 커야 합니다. lpvData가 NULL인 경우 함수는 데이터를 보유하는 데 필요한 바이트 수를 반환합니다.

함수가 성공하고 버퍼 포인터가 NULL이면 반환 값은 버퍼에 필요한 바이트 수입니다. 함수가 성공하고 버퍼 포인터가 유효한 포인터이면 반환 값은 복사된 바이트 수입니다.

함수가 실패하면 반환 값은 0입니다.

Windows 메타파일 비트를 검색한 후 SetMetaFileBitsEx 함수를 호출하여 메모리 기반 메타파일을 만드는 데 사용할 수 있습니다.

GetMetaFileBitsEx 함수는 메타파일 핸들을 무효화하지 않습니다. 애플리케이션은 DeleteMetaFile 함수를 호출하여 이 핸들을 삭제해야 합니다.

Windows 형식 메타파일을 고급 형식 메타파일로 변환하려면 SetWinMetaFileBits 함수를 사용합니다.

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	wingdi.h(Windows.h 포함)
라이브러리	Gdi32.lib
DLL	Gdi32.dll