EngEnumForms 函式 (winddi.h)
EngEnumForms 函式會列舉指定的印表機所支援的表單。
語法
ENGAPI BOOL EngEnumForms(
[in] HANDLE hPrinter,
[in] DWORD Level,
[out, optional] LPBYTE pForm,
[in] DWORD cbBuf,
[out] LPDWORD pcbNeeded,
[out] LPDWORD pcReturned
);
參數
[in] hPrinter
應列舉表單之印表機的句柄。 這是以DrvEnablePDEV的 hDriver 參數傳遞的 PDEV 句柄。
[in] Level
指定 pForm 所指向的結構版本。 這個值必須是 1，這表示列舉形式必須在FORM_1_INFO結構中傳回。
[out, optional] pForm
寫入列舉FORM_INFO_1結構的位元組陣列指標。
[in] cbBuf
指定 lpbForms 的大小，以位元組為單位。
[out] pcbNeeded
DWORD 的指標，如果複製成功完成，則會接收複製到 pForm 的位元元組數目。 如果 pForm 太小而無法包含所有列舉表單的數據，則此 DWORD 會指定所需的位元元組數目。
[out] pcReturned
DWORD 的指標，接收複製到 pForm 的FORM_INFO_1結構數目。
傳回值
如果所有參數都有效，且列舉窗體數據已成功複製到 pForm，則 EngEnumForms 會傳回 TRUE。 否則會傳回 FALSE ，並記錄錯誤訊息。 若要取得錯誤資訊，請呼叫 EngGetLastError。
備註
印表機驅動程式可以呼叫 EngEnumForms ，讓 GDI 取得特定印表機所支援的表單清單。 列舉的資訊會以 pForm 所指向) 的 Microsoft Windows SDK 檔中宣告的FORM_INFO_1結構陣列傳回 (。 如果 pForm 所指向的陣列不夠大，無法儲存列舉的數據，則會改為在 Needed 中傳回必要的數位大小。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | 適用於 Windows 2000 和更新版本的 Windows 作業系統。 |
| 目標平台 | Universal |
| 標頭 | winddi.h (包含Winddi.h) |
| 程式庫 | Win32k.lib |
| Dll | Win32k.sys |