Metodo IPrintTicketProvider::ConvertDevModeToPrintTicket (prdrvcom.h)

  • Articolo

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

Dimensione, 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 restituisce IPrintTicketProvider::ConvertDevModeToPrintTicket , tutte le voci del 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.

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 indicati dal provider di plug-in 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 IPrintTicketProvider::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 di piccole distinzioni 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 LETTERSMALL.

Requisiti

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

Vedi anche

IPrintTicketProvider

IPrintTicketProvider::ConvertPrintTicketToDevMode