IWiaEventCallback::ImageEventCallback メソッド (wia_xp.h)

IWiaEventCallback::ImageEventCallback メソッドは、ハードウェア デバイス イベントが発生したときに、Windows イメージ取得 (WIA) ランタイム システムによって呼び出されます。

構文

HRESULT ImageEventCallback(
  [in]      const GUID *pEventGUID,
  [in]      BSTR       bstrEventDescription,
  [in]      BSTR       bstrDeviceID,
  [in]      BSTR       bstrDeviceDescription,
  [in]      DWORD      dwDeviceType,
  [in]      BSTR       bstrFullItemName,
  [in, out] ULONG      *pulEventType,
  [in]      ULONG      ulReserved
);

パラメーター

[in] pEventGUID

型: const GUID*

イベントの一意識別子を指定します。 デバイス イベントの完全な一覧については、「 WIA イベント識別子」を参照してください。

[in] bstrEventDescription

種類: BSTR

イベントの文字列の説明を指定します。

[in] bstrDeviceID

種類: BSTR

WIA デバイスの一意識別子を指定します。

[in] bstrDeviceDescription

種類: BSTR

デバイスの文字列の説明を指定します。

[in] dwDeviceType

型: DWORD

デバイスの種類を指定します。 使用可能な値の一覧については、「 WIA デバイスの種類指定子 」を参照してください。

[in] bstrFullItemName

種類: BSTR

デバイスを表す WIA 項目の完全な名前を指定します。

[in, out] pulEventType

種類: ULONG*

イベントが通知イベントかアクション イベントか、またはその両方かを指定する ULONG へのポインター。 値 1 は通知イベントを示し、値 2 はアクション イベントを示し、値 3 はイベントが通知とアクションの両方の種類であることを示します。

[in] ulReserved

種類: ULONG

ユーザー情報用に予約されています。

戻り値

型: HRESULT

このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。

解説

WIA ハードウェア デバイス イベントの通知を受け取るために、アプリケーションは IWiaEventCallback インターフェイスへのポインターを RegisterEventCallbackInterface メソッドに渡します。 WIA ランタイム システムはそのインターフェイス ポインターを使用して、WIA ハードウェア デバイス イベントが発生するたびに IWiaEventCallback::ImageEventCallback メソッドを呼び出します。

IWiaEventCallback インターフェイスを登録したのと同じスレッドでコールバックが呼び出される保証はありません。

要件

サポートされている最小のクライアント	Windows 2000 Professional、Windows XP [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム	Windows
ヘッダー	wia_xp.h (Wia.h を含む)
Library	Wiaguid.lib