Condividi tramite


Metodo IPrintTicketProvider::ConvertDevModeToPrintTicket (prdrvcom.h)

Il metodo IPrintTicketProvider::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 di input DEVMODEW. Le dimensioni includono sia le parti pubbliche che private di questa struttura.

[in] pDevmode

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

[in] pPrintTicket

Puntatore al ticket di stampa parzialmente completato. Quando IPrintTicketProvider::ConvertDevModeToPrintTicket viene restituito, tutte le voci nel ticket di stampa devono essere compilate.

Valore restituito

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

Osservazioni

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 indicati dal provider di plug-in deve essere disabilitato. Per questi i campi DEVMODEW disabilitati e non convertiti, il provider di plug-in è responsabile del popolamento dei valori corrispondenti del ticket di stampa. Se lo snapshot di DEVMODEW è stato disabilitato durante una chiamata a IPrintTicketProvider::BindPrinter, la rappresentazione dalla conversione deve fornire informazioni sufficienti per ricostruire la struttura originale DEVMODEW dal ticket di stampa senza perdita di informazioni.

Lo snapshot DEVMODEW consente il supporto per le sottili distinzioni nelle opzioni disponibili 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 LETTERSMALL.

Fabbisogno

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

Vedere anche

IPrintTicketProvider

IPrintTicketProvider::ConvertPrintTicketToDevMode