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

在枚举事件处理程序时使用。 此表中列出了可能的值。

值	说明
WIA_IS_DEFAULT_HANDLER	应使用当前注册的处理程序。 这是枚举事件处理程序时的唯一有效值。 枚举设备的事件功能时，该值不是有效值。
WIA_ACTION_EVENT	事件是操作类型，因此使用持久注册 API IWiaDevMgr：：RegisterEventCallbackProgram 和 IWiaDevMgr：：RegisterEventCallbackCLSID 的程序可以接收它。
WIA_NOTIFICATION_EVENT	事件属于通知类型，因此使用运行时注册函数 IWiaDevMgr：：RegisterEventCallbackInterface 的程序可以接收它。

bstrName

类型： BSTR

指定包含功能名称的简短版本的字符串。

bstrDescription

类型： BSTR

指定一个字符串，其中包含向用户显示的功能的说明。

bstrIcon

类型： BSTR

指定一个字符串，该字符串表示表示此功能或处理程序的图标的位置和资源 ID。 字符串必须采用以下形式：drive：\path\module，n，其中 n 是图标的否定资源 ID (也就是说，如果图标的资源 ID 为 100，则 n 为 -100) 。

bstrCommandline

类型： BSTR

指定表示命令行参数的字符串。

要求

要求	值
最低受支持的客户端	Windows 2000 专业版、Windows XP [仅限桌面应用]
最低受支持的服务器	Windows Server 2003 [仅限桌面应用]
标头	wia_xp.h (包括 Wia.h)