PlayMetaFileRecord 함수(wingdi.h)

PlayMetaFileRecord 함수는 해당 레코드에 포함된 GDI(그래픽 디바이스 인터페이스) 함수를 실행하여 Windows 형식 메타파일 레코드를 재생합니다.

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

구문

BOOL PlayMetaFileRecord(
  [in] HDC           hdc,
  [in] LPHANDLETABLE lpHandleTable,
  [in] LPMETARECORD  lpMR,
  [in] UINT          noObjs
);

[in] hdc

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

[in] lpHandleTable

메타파일을 재생할 때 사용되는 GDI 개체에 대한 핸들 테이블을 나타내는 HANDLETABLE 구조체에 대한 포인터입니다.

[in] lpMR

Windows 형식 메타파일 레코드에 대한 포인터입니다.

[in] noObjs

핸들 테이블의 핸들 수입니다.

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

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

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

애플리케이션은 일반적으로 EnumMetaFile 함수와 함께 PlayMetaFileRecord를 사용하여 한 번에 하나의 Windows 형식 메타파일을 처리하고 재생합니다.

lpHandletable 및 nHandles 매개 변수는 EnumMetaFile에 의해 EnumMetaFileProc 콜백 프로시저에 전달된 매개 변수와 동일해야 합니다.

PlayMetaFileRecord 함수가 레코드를 인식하지 못하는 경우 레코드를 무시하고 TRUE를 반환합니다.

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