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 |