共用方式為


WIA_DEV_CAP_DRV 結構 (wiamindr_lh.h)

WIA_DEV_CAP_DRV結構可用來列舉裝置功能。 裝置功能是由裝置支援的事件或命令所定義。

語法

typedef struct _WIA_DEV_CAP_DRV {
  GUID     *guid;
  ULONG    ulFlags;
  LPOLESTR wszName;
  LPOLESTR wszDescription;
  LPOLESTR wszIcon;
} WIA_DEV_CAP_DRV, *PWIA_DEV_CAP_DRV;

成員

guid

指向識別裝置功能的 GUID。 這個成員可以設定為 WIA 裝置命令所指定的任何值, (WIA_CMD_ XXX 命令) 或 WIA 事件識別碼 (WIA_EVENT_ XXX 事件識別碼) 。 如需詳細資訊,請參閱 WIA 裝置命令

驅動程式可以定義自己的功能 GUID,以便將它向下傳送到裝置。 不過,應用程式必須具備該功能的特定知識,才能回應新功能。 應用程式通常會只辨識標準 WIA 命令和事件 GUID (WIA_CMD_XXX 和WIA_EVENT_XXX) 。

ulFlags

指定事件的類型。 此成員可以設定為下列其中一個或兩者:

旗標 意義
WIA_ACTION_EVENT 應用程式可以使用 IWiaDevMgr::RegisterEventCallbackProgramIwiaDevMgr::RegisterEventCallbackCLSID 方法來註冊指定事件的動作。 動作事件會啟動已註冊來處理這類事件的應用程式。
WIA_NOTIFICATION_EVENT 應用程式可以使用 IwiaDevMgr::RegisterEventCallbackInterface 方法來註冊指定事件的通知。 通知事件只會傳送至已執行的應用程式。

wszName

指定包含功能名稱簡短版本的字串。

wszDescription

指定字串,其中包含可向用戶顯示的功能名稱版本。

wszIcon

指定包含此功能圖示名稱的字串。 圖示可以向用戶顯示。

備註

WIA 服務會呼叫 minidriver 的 IWiaMiniDrv::d rvGetCapabilities 函式,以填入WIA_DEV_CAP_DRV結構的成員。

當驅動程式列舉事件處理程式時,唯一有效的值是WIA_IS_DEFAULT_HANDLER;,表示應該使用目前已註冊的處理程式。

規格需求

需求
標頭 wiamindr_lh.h (包含 Wiamindr.h)

另請參閱

驅動程式功能

IWiaMiniDrv::d rvGetCapabilities