IWiaMiniDrvCallBack::MiniDrvCallback メソッド (wiamindr_lh.h)

MiniDrvCallback メソッドは、コールバック データ転送中に WIA ミニドライバーが使用するためのコールバック メソッドを提供します。

構文

HRESULT MiniDrvCallback(
  [in] LONG                      lReason,
  [in] LONG                      lStatus,
  [in] LONG                      lPercentComplete,
  [in] LONG                      lOffset,
  [in] LONG                      lLength,
  [in] PMINIDRV_TRANSFER_CONTEXT pTranCtx,
  [in] LONG                      lReserved
);

パラメーター

[in] lReason

コールバックステータスメッセージを指定する定数値を指定します。 この値はコールバックの目的を決定するために使用され、次のいずれかの値を指定できます。

[in] lStatus

転送の状態を指定します。 このパラメーターは、次の値のビットごとの OR です。

[in] lPercentComplete

転送されるデータの現在の割合を指定します。

[in] lOffset

バッファーの先頭から転送バッファーへの現在のオフセット (バイト単位) を指定します。

[in] lLength

転送に含まれるバイト数を指定します。

[in] pTranCtx

データ転送値を含む MINIDRV_TRANSFER_CONTEXT 構造体を指します。

[in] lReserved

予約済み。 0 に設定します。

戻り値

メソッドが成功すると、 S_OKが返されます。 クライアント アプリケーションによってコールバックが取り消された場合、メソッドは S_FALSEを返します。 メソッドが失敗した場合は、標準の COM エラー コードが返されます。

注釈

達成率の値は、ドライバーから直接送信されます。 WIA サービスは値を調整しません。

IT_MSG_FILE_PREVIEW_DATA_HEADER は帯域外データ用です。 これにより、ファイル転送を実行するアプリケーションは、縞模様のデータを表示できます。 これは、長さが不明でプレビュー スキャンがないスクロールフィード スキャナーに役立ちます。 このメッセージで報告される情報は、 IT_MSG_DATA_HEADERと同じように扱う必要があります。 ドライバーがこのメッセージをサポートしている場合は、ファイル転送中にプレビュー データを提供できます。

要件

こちらもご覧ください

IWiaMiniDrvCallBack

MINIDRV_TRANSFER_CONTEXT