Funzione DevQueryPrintEx (winddiui.h)

La funzione DevQueryPrintEx dell'interfaccia della stampante determina se un processo di stampa specificato è compatibile con la configurazione corrente della stampante e può quindi essere stampato.

Sintassi

BOOL DevQueryPrintEx(
  [in, out] PDEVQUERYPRINT_INFO pDQPInfo
);

Parametri

[in, out] pDQPInfo

Puntatore fornito dal chiamante a una struttura DEVQUERYPRINT_INFO .

Valore restituito

Se il processo di stampa può essere stampato, la funzione deve restituire TRUE; in caso contrario, deve restituire FALSE.

Commenti

Le DLL dell'interfaccia della stampante devono definire una funzione DevQueryPrintEx . La funzione viene chiamata dallo spooler di stampa se l'opzione Hold Mismatched Documents viene selezionata nella pagina Avanzate del foglio delle proprietà della stampante. Se la funzione restituisce TRUE, lo spooler accoda il processo di stampa per la stampa. In caso contrario, il processo viene mantenuto, in base al presupposto che la stampante verrà riconfigurata in modo che il processo possa stampare.

La struttura DEVQUERYPRINT_INFO ricevuta punta a una struttura DEVMODEW che descrive le caratteristiche della stampante richieste dal processo di stampa. La funzione DevQueryPrintEx deve prima verificare che le dimensioni e i membri della versione della struttura DEVMODEW ricevuta siano compatibili con il driver. Deve quindi determinare se il contenuto DEVMODEW fornito è compatibile con la configurazione della stampante corrente.

Se il processo può essere stampato, la funzione deve restituire TRUE. Se il processo deve essere mantenuto fino a un secondo momento, la funzione deve restituire FALSE dopo aver fornito una stringa di testo visualizzabile (nel buffer puntato dal membro pszErrorStr della struttura di DEVQUERYPRINT_INFO) che descrive il motivo per cui non è possibile stampare il processo.

Le stringhe di testo visualizzabili devono essere definite come risorse stringa in un file di risorse.

Requisiti