GetMetaFileBitsEx 函式 (wingdi.h)

GetMetaFileBitsEx 函式會擷取 Windows 格式元文件的內容，並將其複製到指定的緩衝區。

注意此函式僅供與 Windows 格式元檔相容。增強格式元檔提供較佳的功能，建議用於新的應用程式。增強格式元文件對應的函式是 GetEnhMetaFileBits。

語法

UINT GetMetaFileBitsEx(
  [in]  HMETAFILE hMF,
  [in]  UINT      cbBuffer,
  [out] LPVOID    lpData
);

[in] hMF

Windows 格式元檔句柄。

[in] cbBuffer

要接收數據的緩衝區大小，以位元組為單位。

[out] lpData

接收元數據數據的緩衝區指標。緩衝區必須夠大，才能包含數據。如果 lpvData 為 NULL，函式會傳回保存數據所需的位元元組數目。

如果函式成功且緩衝區指標為 NULL，則傳回值是緩衝區所需的位元組數目;如果函式成功且緩衝區指標是有效的指標，則傳回值是複製的位元組數目。

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

擷取 Windows 元檔位之後，就可以藉由呼叫 SetMetaFileBitsEx 函式來建立以記憶體為基礎的元檔。

GetMetaFileBitsEx 函式不會使元檔句柄失效。應用程式必須藉由呼叫 DeleteMetaFile 函式來刪除此句柄。

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