_WIA_DEV_CAP_DRV structure

The WIA_DEV_CAP_DRV structure is used to enumerate device capabilities. A device capability is defined by an event or command that the device supports.

Syntax

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

Members

guid

Points to a GUID that identifies the device capability. This member can be set to any of the values specified for WIA device commands (WIA_CMD_XXX commands) or WIA event identifiers (WIA_EVENT_XXX event identifiers). See the Microsoft Windows SDK documentation for more information.

The driver can define its own capability GUID that it can send down to the device. An application would need to have specific knowledge about that capability in order for it to be able to respond to the new capability, however. An application normally recognizes only the standard WIA command and event GUIDs (WIA_CMD_XXX and WIA_EVENT_XXX).

ulFlags

Specifies the type of event. This member can be set to one or both of the following:

Flag Meaning
WIA_ACTION_EVENT Application can register action for the given event using the IWiaDevMgr::RegisterEventCallbackProgram and IwiaDevMgr::RegisterEventCallbackCLSID methods, which are described in the Windows SDK documentation. An action event launches the application that is registered to handle such an event.
WIA_NOTIFICATION_EVENT Application can register for notification on the given event using the IwiaDevMgr::RegisterEventCallbackInterface method (described in the Windows SDK documentation). A notification event is sent only to applications that are already running.

wszDescription

Specifies a string containing the version of the capability name that can be displayed to the user.

wszIcon

Specifies a string containing the name of the icon for this capability. The icon can be displayed to the user .

wszName

Specifies a string that contains a short version of the capability name.

Remarks

The WIA service calls the minidriver's IWiaMiniDrv::drvGetCapabilities function to fill in the members of a WIA_DEV_CAP_DRV structure.

When a driver is enumerating event handlers, the only valid value is WIA_IS_DEFAULT_HANDLER; which indicates that the currently registered handler should be used.

Requirements

   
Windows version Available in Windows Me and in Windows XP and later versions of the Windows operating systems. Available in Windows Me and in Windows XP and later versions of the Windows operating systems.
Header wiamindr_lh.h (include Wiamindr.h)

See Also

IWiaMiniDrv::drvGetCapabilities

Driver Capabilities

Send comments about this topic to Microsoft