getWinMetaFileBits 函式 (wingdi.h)

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 參數。

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

規格需求

另請參閱

DeleteEnhMetaFile

中繼檔函式

中繼檔概觀

SetMapMode

SetWinMetaFileBits