GetEnhMetaFilePixelFormat 函式 (wingdi.h)

GetEnhMetaFilePixelFormat 函式會擷取增強元文件的圖元格式資訊。

語法

UINT GetEnhMetaFilePixelFormat(
  HENHMETAFILE          hemf,
  UINT                  cbBuffer,
  PIXELFORMATDESCRIPTOR *ppfd
);

hemf

識別增強型元檔。

cbBuffer

指定複製圖元格式資訊的緩衝區大小，以位元組為單位。

ppfd

包含邏輯圖元格式規格的 PIXELFORMATDESCRIPTOR 結構的指標。元檔會使用此結構來記錄邏輯圖元格式規格。

如果函式成功並尋找圖元格式，則傳回值是元檔圖元格式的大小。

如果沒有像素格式，則傳回值為零。

如果發生錯誤且函式失敗，傳回值會GDI_ERROR。若要取得擴充的錯誤資訊，請呼叫 GetLastError。

當增強型元檔在其 ENHMETAHEADER 結構中指定圖元格式，且圖元格式符合緩衝區時，圖元格式資訊會複製到 ppfd。當 cbBuffer 太小而無法包含元檔的圖元格式時，圖元格式不會複製到緩衝區。不論是哪一種情況，函式都傳回元檔圖元格式的大小。

如需中繼文件錄製和其他作業的相關信息，請參閱增強型元文件作業。