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 を含む)

こちらもご覧ください

IPrintTicketProvider

IPrintTicketProvider::ConvertPrintTicketToDevMode