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 服务调用微型驱动程序的 IWiaMiniDrv::d rvGetCapabilities 函数来填充WIA_DEV_CAP_DRV结构的成员。

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

要求

要求 价值
标头 wiamindr_lh.h (包括 Wiamindr.h)

另请参阅

驱动程序功能

IWiaMiniDrv::d rvGetCapabilities