Metode IPrintTicketProvider::ConvertDevModeToPrintTicket (prdrvcom.h)

  • Artikel

Metode IPrintTicketProvider::ConvertDevModeToPrintTicket mengonversi struktur DEVMODEW menjadi tiket cetak.

Sintaks

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

Parameter

[in] cbDevmode

Ukuran, dalam byte, dari struktur INPUT DEVMODEW . Ukurannya mencakup bagian publik dan privat dari struktur ini.

[in] pDevmode

Penunjuk ke struktur DEVMODEW input, termasuk bagian publik dan privatnya.

[in] pPrintTicket

Penunjuk ke tiket cetak yang diselesaikan sebagian. Ketika IPrintTicketProvider::ConvertDevModeToPrintTicket kembali, semua entri dalam tiket cetak harus diisi.

Nilai kembali

IPrintTicketProvider::ConvertDevModeToPrintTicket harus mengembalikan S_OK jika operasi berhasil. Jika tidak, metode ini harus mengembalikan kode kesalahan COM standar.

Keterangan

Ketika sistem cetak mengonversi konten struktur DEVMODEW menjadi tiket cetak, sistem cetak mengonversi semua bidang DEVMODEW publik kecuali yang telah ditunjukkan oleh penyedia plug-in harus dinonaktifkan. Untuk bidang DEVMODEW yang dinonaktifkan dan tidak dikonversi, penyedia plug-in bertanggung jawab untuk mengisi nilai tiket cetak yang sesuai. Jika rekam jepret DEVMODEW dinonaktifkan selama panggilan ke IPrintTicketProvider::BindPrinter, representasi dari konversi harus memberikan informasi yang cukup untuk membangun kembali struktur DEVMODEW asli dari tiket cetak tanpa kehilangan informasi.

Rekam jepret DEVMODEW memungkinkan dukungan untuk perbedaan halus dalam opsi yang disediakan dalam struktur DEVMODEW yang tiket cetaknya mungkin tidak memiliki representasi. Misalnya, DEVMODEW mungkin mendukung ukuran kertas LETTER sementara tiket cetak mendukung ukuran kertas LETTERSMALL.

Persyaratan

Persyaratan Nilai
Header prdrvcom.h (termasuk Prdrvcom.h)

Lihat juga

IPrintTicketProvider

IPrintTicketProvider::ConvertPrintTicketToDevMode