PlayMetaFile 함수(wingdi.h)

PlayMetaFile 함수는 지정된 디바이스의 지정된 Windows 형식 메타파일에 저장된 그림을 표시합니다.

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

구문

BOOL PlayMetaFile(
  [in] HDC       hdc,
  [in] HMETAFILE hmf
);

[in] hdc

디바이스 컨텍스트에 대한 핸들입니다.

[in] hmf

Windows 형식 메타파일을 처리합니다.

함수가 성공하면 반환 값이 0이 아닙니다.

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

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

Windows 형식 메타파일은 여러 번 재생할 수 있습니다.

Windows 형식 메타파일은 PlayMetaFile 함수를 호출하고 원본 메타파일을 대상 메타파일의 디바이스 컨텍스트로 재생하여 두 번째 Windows 형식 메타파일에 포함할 수 있습니다.

Windows 형식 메타파일에서 생성되었지만 삭제되지 않은 개체는 이 함수에 의해 삭제됩니다.

이 함수를 중지하기 위해 애플리케이션은 다른 스레드에서 CancelDC 함수를 호출하여 작업을 종료할 수 있습니다. 이 경우 함수는 FALSE를 반환 합니다.


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