IPrintTicketProvider2::ConvertDevModeToPrintTicket 方法 (prdrvcom.h)
IPrintTicketProvider2::ConvertDevModeToPrintTicket 方法會將 DEVMODEW 結構轉換成列印票證。
語法
HRESULT ConvertDevModeToPrintTicket(
[in] IN ULONG cbDevmode,
[in] IN PDEVMODE pDevmode,
[in] IN IXMLDOMDocument2 *pPrintTicket
);
參數
[in] cbDevmode
輸入 DEVMODEW 結構的大小,以位元組為單位。 大小同時包含這個 結構的公用和私用部分。
[in] pDevmode
輸入 DEVMODEW 結構的指標,包括其公用和私用部分。
[in] pPrintTicket
部分完成列印票證的指標。 當 IPrintTicketProvider2::ConvertDevModeToPrintTicket 傳回時,列印票證中的所有專案都應該填入。
傳回值
IPrintTicketProvider2::ConvertDevModeToPrintTicket 如果作業成功,應該傳回 S_OK。 否則,此方法應該會傳回標準 COM 錯誤碼。
言論
當列印系統將 DEVMODEW 結構的內容轉換成列印票證時,它會轉換所有公用 DEVMODEW 欄位,但外掛程式提供者已指出應該停用的內容。 針對這些 DEVMODEW 停用且未轉換的欄位,外掛程式提供者會負責填入對應的列印票證值。 如果在呼叫 IPrintTicketProvider2::BindPrinter 時停用 DEVMODEW 快照集,轉換中的表示法必須提供足夠的資訊,才能從列印票證重建原始 DEVMODEW 結構,而不會遺失資訊。
DEVMODEW 快照集允許支援在 DEVMODEW 結構中提供之選項的細微差別,而列印票證可能沒有表示法。 例如,DEVMODEW 可能會支援 LETTER 紙張大小,而列印票證支援 LETTERMALL 紙張大小。
要求
要求 | 價值 |
---|---|
標頭 | prdrvcom.h (包括 Prdrvcom.h) |