GetEnhMetaFilePixelFormat 関数 (wingdi.h)
GetEnhMetaFilePixelFormat 関数は、拡張メタファイルのピクセル形式情報を取得します。
構文
UINT GetEnhMetaFilePixelFormat(
HENHMETAFILE hemf,
UINT cbBuffer,
PIXELFORMATDESCRIPTOR *ppfd
);
パラメーター
hemf
拡張メタファイルを識別します。
cbBuffer
ピクセル形式情報をコピーするバッファーのサイズをバイト単位で指定します。
ppfd
論理ピクセル形式の指定を含む PIXELFORMATDESCRIPTOR 構造体へのポインター。 メタファイルはこの構造を使用して、論理ピクセル形式の仕様を記録します。
戻り値
関数が成功し、ピクセル形式が見つかると、戻り値はメタファイルのピクセル形式のサイズになります。
ピクセル形式が存在しない場合、戻り値は 0 になります。
エラーが発生し、関数が失敗した場合、戻り値はGDI_ERROR。 詳細なエラー情報を得るには、GetLastError を呼び出します。
解説
拡張メタファイルが ENHMETAHEADER 構造体でピクセル形式を指定し、ピクセル形式がバッファーに収まる場合、ピクセル形式情報は ppfd にコピーされます。 cbBuffer が小さすぎてメタファイルのピクセル形式が含まれていない場合、ピクセル形式はバッファーにコピーされません。 どちらの場合も、 関数はメタファイルのピクセル形式のサイズを返します。
メタファイルの記録とその他の操作については、「拡張メタファイル操作」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | wingdi.h |
| Library | Gdi32.lib |
| [DLL] | Gdi32.dll |