次の方法で共有


IPrintOemDriverUni::D rvWriteAbortBuf メソッド (prcomoem.h)

IPrintOemDriverUni::DrvWriteAbortBuf メソッドは、ユーザーが印刷ジョブを終了した後、OEM レンダリング プラグイン がプリンターのクリーンアップ コードを送信できるようにするために、Unidrv ドライバーによって提供されます。

構文

HRESULT DrvWriteAbortBuf(
  PDEVOBJ pdevobj,
  PVOID   pBuffer,
  DWORD   cbSize,
  DWORD   dwWait
);

パラメーター

pdevobj

DEVOBJ 構造体への呼び出し元指定ポインター。

pBuffer

プリンターに送信されるコード フラグメントを含むバッファーへの呼び出し元が指定したポインター。

cbSize

pBuffer が指すバッファー内の呼び出し元が指定バイト数。

dwWait

現在のジョブが中止された後に新しい印刷ジョブを開始するまでに、プリンターが待機する必要がある呼び出し元が指定した時間 (ミリ秒単位)。

戻り値

このメソッドは、次のいずれかの値を返す必要があります。

リターン コード 形容
S_OK
操作は成功しました。
E_FAIL
操作が失敗しました。
E_NOTIMPL
メソッドは実装されていません。

備考

OEM は、IPrintOemDriverUni::D rvWriteSpoolBuf を使用してプリンターに出力を送信します。 ユーザーが印刷ジョブを終了した場合、IPrintOemDriverUni::DrvWriteSpoolBuf はE_FAILを返し、プリンターにデータを送信するために使用できなくなります。 この場合、特定のプリンターは、新しい印刷ジョブを開始する前に状態をリセットして、クリーンアップ コード フラグメントを送信する必要があります。 これらのプリンターでは、このコード フラグメントをプリンターに送信するために IPrintOemDriverUni::DrvWritetAbortBuf が使用されます。

IPrintOemDriverUni::DrvWriteAbortBuf は、IPrintOemDriverUni::DrvWriteSpoolBuf がE_FAILを返した後にのみ呼び出すことができます。 IPrintOemDriverUni::DrvWriteAbortBuf は、ジョブごとに複数回呼び出さないでください。

レンダリング プラグインについては、「Microsoft のプリンター ドライバーのカスタマイズ」を参照してください。

必要条件

要件 価値
ターゲット プラットフォーム デスクトップ
ヘッダー prcomoem.h (Prcomoem.h を含む)