Metodo IPrintTicketProvider2::ConvertDevModeToPrintTicket (prdrvcom.h)

Articolo
02/29/2024

Il metodo IPrintTicketProvider2::ConvertDevModeToPrintTicket converte una struttura DEVMODEW in un ticket di stampa.

Sintassi

HRESULT ConvertDevModeToPrintTicket(
  [in] IN ULONG            cbDevmode,
  [in] IN PDEVMODE         pDevmode,
  [in] IN IXMLDOMDocument2 *pPrintTicket
);

Parametri

[in] cbDevmode

Dimensioni, in byte, della struttura DEVMODEW di input. Le dimensioni includono sia le parti pubbliche che private di questa struttura.

[in] pDevmode

Puntatore alla struttura DEVMODEW di input, incluse le parti pubbliche e private.

[in] pPrintTicket

Puntatore al ticket di stampa parzialmente completato. Quando IPrintTicketProvider2::ConvertDevModeToPrintTicket restituisce , tutte le voci del ticket di stampa devono essere compilate.

Valore restituito

IPrintTicketProvider2::ConvertDevModeToPrintTicket deve restituire S_OK se l'operazione ha esito positivo. In caso contrario, questo metodo deve restituire un codice di errore COM standard.

Commenti

Quando il sistema di stampa converte il contenuto di una struttura DEVMODEW in un ticket di stampa, converte tutti i campi DEVMODEW pubblici, ad eccezione di quelli che il provider di plug-in ha indicato deve essere disabilitato. Per questi campi DEVMODEW disabilitati e non convertiti, il provider di plug-in è responsabile del popolamento dei valori corrispondenti del ticket di stampa. Se lo snapshot DEVMODEW è stato disabilitato durante una chiamata a IPrintTicketProvider2::BindPrinter, la rappresentazione dalla conversione deve fornire informazioni sufficienti per ricostruire la struttura DEVMODEW originale dal ticket di stampa senza perdere informazioni.

Lo snapshot DEVMODEW consente il supporto per le sottili distinzione nelle opzioni fornite nella struttura DEVMODEW per cui il ticket di stampa potrebbe non avere rappresentazioni. Ad esempio, DEVMODEW potrebbe supportare le dimensioni della carta LETTER mentre il ticket di stampa supporta le dimensioni della carta LETTERMALL.

Requisiti

Requisito	Valore
Intestazione	prdrvcom.h (include Prdrvcom.h)

Vedi anche

IPrintTicketProvider2

IPrintTicketProvider2::ConvertPrintTicketToDevMode

Condividi tramite