IWiaDevMgr2::RegisterEventCallbackInterface メソッド

Windows Image Acquisition (WIA) 2.0 イベント通知用に実行中のアプリケーションを登録します。

構文

HRESULT RegisterEventCallbackInterface(
  [in]        LONG              lFlags,
  [in]        BSTR              bstrDeviceID,
  [in]  const GUID              *pEventGUID,
  [in]        IWiaEventCallback *pIWiaEventCallback,
  [out]       IUnknown          **pEventObject
);

パラメーター

lFlags [in]

型: LONG

現在使用されていません。 ゼロに設定してください。

bstrDeviceID [in]

種類: BSTR

WIA 2.0 デバイスの一意識別子を指定します。 すべての WIA 2.0 デバイスでイベントを登録するには、このパラメーターを NULL に設定します。

pEventGUID [in]

型: const GUID*

アプリケーションが登録するイベント識別子へのポインターを指定します。 標準 のイベント識別子については、「WIA イベント 識別子」を参照してください。

pIWiaEventCallback [in]

種類: IWiaEventCallback*

WIA 2.0 がイベント通知の送信に使用する IWiaEventCallback インターフェイスへのポインターを指定します。

pEventObject [out]

種類: IUnknown**

IUnknown インターフェイスへのポインターのアドレスを受け取ります。

戻り値

種類: HRESULT

標準の COM エラー コードまたは次のエラー コードを返します。

リターン コード	説明
E_NOTIMPL	IUnknown インターフェイスを返すことはできません。

 

解説

警告

同じプロセスで IWiaDevMgr::RegisterEventCallbackInterface、 IWiaDevMgr2::RegisterEventCallbackInterface、 DeviceManager.RegisterEvent メソッドを使用すると、サービスが停止する前に関数が使用されていた場合、アクセス違反が発生する可能性があります。

 

WIA 2.0 アプリケーションの実行が開始されると、このメソッドを使用してハードウェア デバイス イベントを受信するために登録されます。 これにより、登録されている別のイベントが発生したときにアプリケーションが再起動されなくなります。 アプリケーションが IWiaDevMgr2::RegisterEventCallbackInterface を呼び出してデバイスから WIA 2.0 イベントを受信するように登録すると、登録されたイベントは WIA 2.0 によってプログラムにルーティングされます。

アプリケーションは、pEventObject パラメーターを介して受け取るインターフェイス ポインターで IUnknown::Release メソッドを呼び出す必要があります。

注意

マルチスレッド アプリケーションでは、イベント通知コールバックは、コールバックを登録したスレッドとは異なるスレッドで送信される場合があります。

 

要件

要件	値
サポートされている最小のクライアント	Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップ アプリのみ]
ヘッダー	Wia.h
IDL	Wia.idl