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 の場合、戻り値はバッファーに必要なバイト数です。関数が成功し、バッファーポインターが有効なポインターである場合、戻り値はコピーされたバイト数です。

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

Windows メタファイルビットを取得した後、 SetMetaFileBitsEx 関数を呼び出してメモリベースのメタファイルを作成するために使用できます。

GetMetaFileBitsEx 関数はメタファイルハンドルを無効にしません。アプリケーションでは、 DeleteMetaFile 関数を呼び出してこのハンドルを削除する必要があります。

Windows 形式のメタファイルを拡張形式のメタファイルに変換するには、 SetWinMetaFileBits 関数を使用します。

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