WIA_DEV_CAP 結構 (wia_xp.h)

應用程式會使用 WIA_DEV_CAP 結構來列舉裝置功能。 裝置功能是由裝置支援的事件或命令所定義。 如需詳細資訊，請參閱 IEnumWIA_DEV_CAPS。

語法

typedef struct _WIA_DEV_CAP {
  GUID  guid;
  ULONG ulFlags;
  BSTR  bstrName;
  BSTR  bstrDescription;
  BSTR  bstrIcon;
  BSTR  bstrCommandline;
} WIA_DEV_CAP, *PWIA_DEV_CAP, WIA_EVENT_HANDLER, *PWIA_EVENT_HANDLER;

成員

guid

類型： GUID

指定識別裝置功能的 GUID。 這個成員可以設定為 WIA 裝置命令 或 WIA 事件識別碼中指定的任何值。

ulFlags

類型： ULONG

列舉事件處理程式時使用。 可能的值列在此表格中。

值	Description
WIA_IS_DEFAULT_HANDLER	應該使用目前已註冊的處理程式。 這是列舉事件處理程式時的唯一有效值。 列舉裝置的事件功能時，它不是有效的值。
WIA_ACTION_EVENT	事件屬於動作類型，因此使用持續性註冊 API 、IWiaDevMgr：：RegisterEventCallbackProgram 和 IWiaDevMgr：：RegisterEventCallbackCLSID 的程式可以接收它。
WIA_NOTIFICATION_EVENT	事件屬於通知類型，因此使用運行時間註冊函式 IWiaDevMgr：：RegisterEventCallbackInterface 的程式可以接收它。

bstrName

類型： BSTR

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

bstrDescription

類型： BSTR

指定字串，其中包含向用戶顯示之功能的描述。

bstrIcon

類型： BSTR

指定字串，表示代表這個功能或處理程式之圖示的位置和資源標識碼。 字串的格式必須是：drive：\path\module，n是圖示的否定資源標識符 (也就是說，如果圖標的資源標識符是 100，則 n 是 -100) 。

bstrCommandline

類型： BSTR

指定表示命令行自變數的字串。

規格需求

需求	值
最低支援的用戶端	Windows 2000 Professional、Windows XP [僅限桌面應用程式]
最低支援的伺服器	Windows Server 2003 [僅限桌面應用程式]
標頭	wia_xp.h (包含 Wia.h)