wiasQueueEvent 関数 (wiamdef.h)
wiasQueueEvent 関数は、デバイスがイベントを生成したことをサービスに通知します。
構文
HRESULT wiasQueueEvent(
[in] BSTR bstrDeviceId,
[in] const GUID *pEventGUID,
[in, optional] BSTR bstrFullItemName
);
パラメーター
[in] bstrDeviceId
デバイス ID を指定します。 これは、 IWiaMiniDrv::d rvInitializeWia メソッドの呼び出しでミニドライバーに渡される値です。
[in] pEventGUID
イベントの GUID を含むバッファーへのポインター。
[in, optional] bstrFullItemName
パス情報を含む完全な項目名を指定します。
戻り値
成功すると、関数はS_OKを返します。
関数が失敗した場合は、標準 COM エラーまたは WIA エラー コードのいずれかが返されます。
注釈
このメソッドは、デバイスが何らかの種類のイベントが発生したことを通知する必要がある場合に常に使用する必要があります。 デバイスは、イベント キューにイベントを配置することでこれを行います。 たとえば、カメラが新しい画像を取得すると、新しいドライバー項目をツリーに追加した後にWIA_EVENT_ITEM_CREATED イベントが生成されます。 カメラは、次の方法でイベント キューにこのイベントを配置できます。
hr = wiasQueueEvent(bstrMyDeviceId,
&WIA_EVENT_ITEM_CREATED,
bstrDescriptionString);
WIA イベント識別子の完全な一覧については、Windows SDKドキュメントを参照してください。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | デスクトップ |
| Header | wiamdef.h (Wiamdef.h を含む) |
| Library | Wiaservc.lib |
| [DLL] | Wiaservc.dll |