GetEnhMetaFilePixelFormat

GetEnhMetaFilePixelFormat 関数は、拡張メタファイルのピクセルフォーマット情報を取得する。

GetEnhMetaFilePixelFormat hemf, cbBuffer, ppfd

hemf : [intptr] 拡張メタファイルを識別する。
cbBuffer : [int] ピクセルフォーマット情報をコピーするバッファのサイズ(バイト単位)を指定する。
ppfd : [var] 論理ピクセルフォーマット仕様を含む PIXELFORMATDESCRIPTOR 構造体へのポインタ。メタファイルはこの構造体を使って論理ピクセルフォーマット仕様を記録する。

(プラグイン / モジュール : gdi32.dll)

解説

GetEnhMetaFilePixelFormat 関数は、拡張メタファイルのピクセルフォーマット情報を取得する。

[戻り値]

関数が成功しピクセルフォーマットが見つかった場合、戻り値はメタファイルのピクセルフォーマットのサイズである。ピクセルフォーマットがない場合は
0 である。エラーが発生して関数が失敗した場合は GDI_ERROR である。拡張エラー情報を取得するには GetLastError
を呼ぶ。

[備考]
拡張メタファイルが ENHMETAHEADER
構造体にピクセルフォーマットを指定しており、そのピクセルフォーマットがバッファに収まる場合、ピクセルフォーマット情報が ppfd
にコピーされる。cbBuffer
がメタファイルのピクセルフォーマットを格納するには小さすぎる場合、バッファにはコピーされない。いずれの場合も関数はメタファイルのピクセルフォーマットのサイズを返す。メタファイル記録やその他の操作については「拡張メタファイル操作」を参照。

情報