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 |