Funzione EngEnumForms (winddi.h)

Articolo
08/27/2023

La funzione EngEnumForms enumera i moduli supportati dalla stampante specificata.

Sintassi

ENGAPI BOOL EngEnumForms(
  [in]            HANDLE  hPrinter,
  [in]            DWORD   Level,
  [out, optional] LPBYTE  pForm,
  [in]            DWORD   cbBuf,
  [out]           LPDWORD pcbNeeded,
  [out]           LPDWORD pcReturned
);

Parametri

[in] hPrinter

Handle per la stampante per cui devono essere enumerati i moduli. Si tratta dell'handle PDEV passato come parametro hDriver di DrvEnablePDEV.

[in] Level

Specifica la versione della struttura a cui punta pForm. Questo valore deve essere 1, che indica che i moduli enumerati devono essere restituiti nelle strutture FORM_1_INFO.

[out, optional] pForm

Puntatore a una matrice di byte in cui vengono scritte le strutture FORM_INFO_1 enumerate.

[in] cbBuf

Specifica le dimensioni, in byte, di lpbForms.

[out] pcbNeeded

Puntatore a un DWORD che riceve il numero di byte copiati in pForm se la copia viene completata correttamente. Se pForm è troppo piccolo per contenere tutti i dati dei moduli enumerati, questo DWORD specifica il numero di byte necessari.

[out] pcReturned

Puntatore a un DWORD che riceve il numero di strutture FORM_INFO_1 copiate in pForm.

Valore restituito

EngEnumForms restituisceTRUE se tutti i parametri sono validi e i dati del modulo enumerati vengono copiati correttamente in pForm. In caso contrario, restituisce FALSE e viene registrato un messaggio di errore. Per ottenere informazioni sull'errore, chiamare EngGetLastError.

Commenti

Un driver della stampante può chiamare EngEnumForms per ottenere l'elenco di moduli supportati da una determinata stampante. Le informazioni enumerate vengono restituite come matrice di strutture FORM_INFO_1 (dichiarate nella documentazione Microsoft Windows SDK) a cui punta pForm. Se la matrice a cui punta pForm non è sufficiente per contenere i dati enumerati, la dimensione della matrice necessaria viene invece restituita in pcbNeeded.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile in Windows 2000 e versioni successive dei sistemi operativi Windows.
Piattaforma di destinazione	Universale
Intestazione	winddi.h (include Winddi.h)
Libreria	Win32k.lib
DLL	Win32k.sys

Vedi anche

DrvEnablePDEV

EngGetLastError

Condividi tramite