PrintDocumentOnPrintProcessor 関数 (winsplp.h)

  • [アーティクル]

印刷プロセッサの PrintDocumentOnPrintProcessor 関数は、印刷ジョブをスプール形式から、印刷モニターに送信できる生データに変換します。

構文

BOOL PrintDocumentOnPrintProcessor(
  [in] HANDLE hPrintProcessor,
  [in] LPWSTR pDocumentName
);

パラメーター

[in] hPrintProcessor

呼び出し元から提供される印刷プロセッサ ハンドル。 これは、 OpenPrintProcessor の以前の呼び出しによって返されたハンドルです。

[in] pDocumentName

呼び出し元が指定したドキュメント名へのポインター。

戻り値

操作が成功した場合、関数は TRUE を返す必要があります。 操作が失敗した場合、関数は SetLastError を呼び出してエラー コードを設定し、 FALSE を返す必要があります。

注釈

関数をエクスポートするには、印刷プロセッサが PrintDocumentOnPrintProcessor 必要です。 スプーラーは、 OpenPrintProcessor を呼び出した後に 関数を呼び出します。 この関数の目的は、 pDocumentName という名前のファイルの内容を読み取り、(必要に応じて) ファイルのデータをプリンター ハードウェアで読み取ることができるデータ ストリームに変換し、データ ストリームをスプーラーに送信することです。 スプーラーは、適切な 印刷モニターにデータ ストリームを送信できます。

入力形式が NT ベースのオペレーティング システム EMF の場合、 PrintDocumentOnPrintProcessor 関数は 印刷プロセッサの GDI 関数を呼び出すことができます。 詳細については、「 印刷ジョブの処理」を参照してください。

変換されたデータ ストリームは、Microsoft Windows SDKドキュメントで説明されている WritePrinter を呼び出してスプーラーに返送する必要があります。 詳細については、「 印刷ジョブの処理」を参照してください。

この関数は PrintDocumentOnPrintProcessor 、印刷ジョブを一時停止、再開、または取り消す要求を処理するために記述する必要があります。 詳細については、「 ControlPrintProcessor」を参照してください。

要件

要件 値
対象プラットフォーム デスクトップ
Header winsplp.h (Winsplp.h を含む)
Library Nwprint.lib

こちらもご覧ください

ControlPrintProcessor

OpenPrintProcessor