データ転送をキャンセルする

重要

この記事には、旧 Windows オペレーティング システムに適用される情報が含まれています。

WIA アプリケーションと WIA ミニドライバーは、いつでもデータ転送をキャンセルできます。 WIA ミニドライバーは IWiaMiniDrvCallBack::MiniDrvCallback メソッドによって返される値をチェックすることによって、アプリケーションがデータ転送をキャンセルしたかどうかを判断できます。 メソッドが S_FALSE を返す場合、データ転送は取り消されました。 WIA ミニドライバーは、すべての取得アクティビティを停止し、アイドル状態に戻る必要があります。 その後、次のデータ転送の準備が整います。

WIA ミニドライバーは IWiaMiniDrv::drvAcquireItemData メソッドから S_FALSE を返すことによって、データ転送が取り消されたことを通知できます。 一部のデバイスには、データ転送を中止できるハードウェアにキャンセル ボタンがあります。 このような場合、WIA ミニドライバーは S_FALSE を返す必要があります。

エラーを宣言して S_FALSE を返すことなく、WIA スキャンをキャンセルできます。 ただし、これは Windows XP 以降のオペレーティング システムでのみ可能です。Windows Millennium Edition では使用できません。

IWiaMiniDrvCallBack::MiniDrvCallback メソッドから受信したすべてのリターン コードは、 IWiaMiniDrv::drvAcquireItemData メソッドで返す必要があります。 アプリケーションが IWiaMiniDrvCallBack::MiniDrvCallback メソッドでエラー コードを返す場合、WIA ミニドライバーはデータ転送を停止し、アイドル状態に戻り、そのエラー コードを WIA サービスに返す必要があります。