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 はレター用紙サイズをサポートし、印刷チケットは LETTERMALL 用紙サイズをサポートします。

必要条件

要件	価値
ヘッダー	prdrvcom.h (Prdrvcom.h を含む)

関連項目

IPrintTicketProvider2 の

IPrintTicketProvider2::ConvertPrintTicketToDevMode