getWinMetaFileBits 函式 (wingdi.h)

發行項
08/27/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，則傳回值是儲存轉換記錄所需的位元組數目;如果函式成功且緩衝區指標是有效的指標，則傳回值會是位元組的中繼檔資料大小。

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

備註

此函式會將增強型中繼檔轉換成 Windows 格式中繼檔，使其圖片可以顯示在可辨識較舊格式的應用程式中。

系統會使用參考裝置內容來判斷已轉換中繼檔解析度。

GetWinMetaFileBits函式不會使增強型中繼檔控制碼失效。應用程式應該呼叫 DeleteEnhMetaFile 函式，以在不再需要控制碼時釋放控制碼。

若要建立可調整的 Windows 格式中繼檔，請將MM_ANISOTROPIC指定為 fnMapMode 參數。

中繼檔圖片的左上角一律會對應至參考裝置的來源。

規格需求


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