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 の場合、戻り値は変換されたレコードを格納するために必要なバイト数です。関数が成功し、バッファー ポインターが有効なポインターである場合、戻り値はメタファイル データのサイズ (バイト単位) です。

関数が失敗した場合は、0 を返します。

解説

この関数は、拡張メタファイルを Windows 形式のメタファイルに変換して、古い形式を認識するアプリケーションで画像を表示できるようにします。

システムは、参照デバイス コンテキストを使用して、変換されたメタファイルの解決を決定します。

GetWinMetaFileBits 関数は、拡張メタファイル ハンドルを無効にしません。 アプリケーションは DeleteEnhMetaFile 関数を呼び出して、不要になったときにハンドルを解放する必要があります。

スケーラブルな Windows 形式のメタファイルを作成するには、 fnMapMode パラメーターとして MM_ANISOTROPICを指定します。

メタファイル画像の左上隅は、常に参照デバイスの原点にマップされます。

要件

サポートされている最小のクライアント	Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	wingdi.h (Windows.h を含む)
Library	Gdi32.lib
[DLL]	Gdi32.dll

関連項目

DeleteEnhMetaFile

メタファイル関数

メタファイルの概要

SetMapMode

SetWinMetaFileBits