IPrintOemPrintTicketProvider::ConvertDevModeToPrintTicket メソッド (prcomoem.h)

IPrintOemPrintTicketProvider::ConvertDevModeToPrintTicket メソッドは、DEVMODEW 構造体を印刷チケットに変換します。

構文

HRESULT ConvertDevModeToPrintTicket(
  [in]      ULONG            cbDevmode,
  [in]      PDEVMODE         pDevmode,
  [in]      ULONG            cbDrvPrivateSize,
  [in]      PVOID            pPrivateDevmode,
  [in, out] IXMLDOMDocument2 *pPrintTicket
);

パラメーター

[in] cbDevmode

入力 DEVMODEW 構造体のサイズ (バイト単位)。 サイズには、この構造体のパブリック部分とプライベート部分の両方が含まれます。

[in] pDevmode

入力 DEVMODEW 構造体へのポインター。

[in] cbDrvPrivateSize

プラグインのプライベート DEVMODEW 構造体のサイズ (バイト単位)。

[in] pPrivateDevmode

プラグインのプライベート DEVMODEW 構造体へのポインター。

[in, out] pPrintTicket

部分的に完了した印刷チケットへのポインター。 IPrintOemPrintTicketProvider::ConvertDevModeToPrintTicket が返されるときに、印刷チケット内のすべてのエントリを入力する必要があります。

戻り値

操作が成功した場合、IPrintOemPrintTicketProvider::ConvertDevModeToPrintTicket はS_OKを返す必要があります。 それ以外の場合、このメソッドは標準の COM エラー コードを返す必要があります。

注釈

コア ドライバーは、 IPrintOemPrintTicketProvider::ConvertDevModeToPrintTicket メソッドを呼び出します。入力印刷チケットには、パブリック機能と Unidrv プライベート機能または Pscript5 プライベート機能が設定されています。 プラグインは、入力印刷チケットの設定に基づいて、パブリック パーツまたはプラグインのプライベート パーツで DEVMODEW 設定を自由に設定できます。 プラグインは、新しい DEVMODEW 項目の設定に加えて、DEVMODEW 構造体のパブリック部分の既存の設定を変更できます。

クライアントに関心のある DEVMODEW 構造体の一部と関連付ける DEVMODEW 構造体フィールドは、 IPrintOemPrintTicketProvider::ConvertDevModeToPrintTicket が呼び出される前に既に設定されています。これには、DEVMODEW 構造体のパブリック部分を含め、DEVMODEW 構造体のパブリック部分でプライベートに定義された値が除外されます。

要件

要件
対象プラットフォーム デスクトップ
Header prcomoem.h (Prcomoem.h を含む)

こちらもご覧ください

IPrintOemPrintTicketProvider

IPrintOemPrintTicketProvider::ConvertPrintTicketToDevMode