共用方式為

wiasQueueEvent 函式 (wiamdef.h)

  • 發行項

wiasQueueEvent 函式會通知服務裝置產生事件。

語法

HRESULT wiasQueueEvent(
  [in]           BSTR       bstrDeviceId,
  [in]           const GUID *pEventGUID,
  [in, optional] BSTR       bstrFullItemName
);

參數

[in] bstrDeviceId

指定裝置識別碼。 這是在 呼叫 IWiaMiniDrv：:d rvInitializeWia 方法中傳遞至 minidriver 的值。

[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 檔。

規格需求

需求 值
目標平台 桌面
標頭 wiamdef.h (包含Wiamdef.h)
程式庫 Wiaservc.lib
Dll Wiaservc.dll

另請參閱

IWiaMiniDrv：:d rvInitializeWia