playMetaFile 函式 (wingdi.h)

PlayMetaFile函式會顯示儲存在指定裝置上指定 Windows 格式中繼檔中的圖片。

注意此函式僅供與 Windows 格式中繼檔相容。增強格式中繼檔提供絕佳的功能，建議用於新的應用程式。增強格式中繼檔對應的函式是 PlayEnhMetaFile。

語法

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

[in] hdc

裝置內容的控制代碼。

[in] hmf

Windows 格式中繼檔控制碼。

如果函式成功，則傳回非零的值。

如果此函式失敗，則傳回值為零。

若要將 Windows 格式中繼檔轉換成增強格式中繼檔，請使用 SetWinMetaFileBits 函式。

Windows 格式中繼檔可以多次播放。

Windows 格式中繼檔可以內嵌到第二個 Windows 格式中繼檔，方法是呼叫 PlayMetaFile 函式，並將來源中繼檔播放至目標中繼檔的裝置內容。

此函式會刪除以 Windows 格式中繼檔建立但未刪除的任何物件。

若要停止此函式，應用程式可以從另一個執行緒呼叫 CancelDC 函式來終止作業。在此情況下，函式會傳回 FALSE。


最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
目標平台	Windows
標頭	wingdi.h (包含 Windows.h)
程式庫	Gdi32.lib
Dll	Gdi32.dll