IPrintTicketProvider::ConvertDevModeToPrintTicket メソッド (prdrvcom.h)
IPrintTicketProvider::ConvertDevModeToPrintTicket メソッドは、DEVMODEW 構造体を印刷チケットに変換します。
構文
HRESULT ConvertDevModeToPrintTicket(
[in] IN ULONG cbDevmode,
[in] IN PDEVMODE pDevmode,
[in] IN IXMLDOMDocument2 *pPrintTicket
);
パラメーター
[in] cbDevmode
入力 DEVMODEW 構造体のサイズ (バイト単位)。 サイズには、この構造体のパブリック部分とプライベート部分の両方が含まれます。
[in] pDevmode
パブリック部分とプライベート部分を含む入力 DEVMODEW 構造体へのポインター。
[in] pPrintTicket
部分的に完了した印刷チケットへのポインター。 IPrintTicketProvider::ConvertDevModeToPrintTicket が返されるときに、印刷チケット内のすべてのエントリを入力する必要があります。
戻り値
操作が成功した場合、IPrintTicketProvider::ConvertDevModeToPrintTicket はS_OKを返す必要があります。 それ以外の場合、このメソッドは標準の COM エラー コードを返す必要があります。
注釈
印刷システムは、 DEVMODEW 構造体の内容を印刷チケットに変換する場合、プラグイン・プロバイダーが使用不可にすべきであることを示すものを除き、すべてのパブリック DEVMODEW フィールドを変換します。 無効で変換されない これらの DEVMODEW フィールドの場合、プラグイン プロバイダーは対応する印刷チケット値を設定する役割を担います。 IPrintTicketProvider::BindPrinter の呼び出し中に DEVMODEW スナップショットが無効にされた場合、変換からの表現は、情報を失うことなく、印刷チケットから元の DEVMODEW 構造を再構築するのに十分な情報を提供する必要があります。
DEVMODEW スナップショットを使用すると、印刷チケットに表現がない可能性がある DEVMODEW 構造体で提供されるオプションの微妙な違いをサポートできます。 たとえば、 DEVMODEW では LETTER 用紙サイズがサポートされ、印刷チケットでは LETTERSMALL 用紙サイズがサポートされる場合があります。
要件
要件 | 値 |
---|---|
Header | prdrvcom.h (Prdrvcom.h を含む) |