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：：RegisterEventCallbackProgram 和 IwiaDevMgr：：RegisterEventCallbackCLSID 方法为给定事件注册操作。 操作事件启动已注册以处理此类事件的应用程序。
WIA_NOTIFICATION_EVENT 应用程序可以使用 IwiaDevMgr：：RegisterEventCallbackInterface 方法注册给定事件的通知。 通知事件仅发送到已在运行的应用程序。

wszName

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

wszDescription

指定包含可向用户显示的功能名称版本的字符串。

wszIcon

指定包含此功能图标名称的字符串。 图标可以向用户显示。

注解

WIA 服务调用微型驱动程序的 IWiaMiniDrv：:d rvGetCapabilities 函数来填充WIA_DEV_CAP_DRV结构的成员。

当驱动程序枚举事件处理程序时，唯一有效的值是WIA_IS_DEFAULT_HANDLER;指示应使用当前注册的处理程序。

要求

要求 值
Header wiamindr_lh.h (包括 Wiamindr.h)

另请参阅

驱动程序功能

IWiaMiniDrv：:d rvGetCapabilities