Export (0) Print
Expand All

WIA_DEV_CAP structure

Applications use the WIA_DEV_CAP structure to enumerate device capabilities. A device capability is defined by an event or command that the device supports. For more information, see IEnumWIA_DEV_CAPS.

Syntax


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;

Members

guid

Type: GUID

Specifies a GUID that identifies the device capability. This member can be set to any of the values specified in WIA Device Commands or WIA Event Identifiers.

ulFlags

Type: ULONG

Used when enumerating event handlers. The possible values are listed in this table.

ValueDescription
WIA_IS_DEFAULT_HANDLERThe currently registered handler should be used. This is the only valid value when enumerating event handlers. It is not a valid value when enumerating event capabilities of a device.
WIA_ACTION_EVENTThe event is of the action type, so programs that use persistent registration APIs, IWiaDevMgr::RegisterEventCallbackProgram and IWiaDevMgr::RegisterEventCallbackCLSID, can receive it.
WIA_NOTIFICATION_EVENTThe event is of the notification type, so programs that use the runtime registration function, IWiaDevMgr::RegisterEventCallbackInterface, can receive it.

 

bstrName

Type: BSTR

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

bstrDescription

Type: BSTR

Specifies a string that contains a description of the capability that is displayed to the user.

bstrIcon

Type: BSTR

Specifies a string that represents the location and resource ID of the icon that represents this capability or handler. The string must be of the following form: drive:\path\module,n, where n is the icon's negated resource ID (that is, if the resource ID of the icon is 100, then n is -100).

bstrCommandline

Type: BSTR

Specifies a string that represents command line arguments.

Requirements

Minimum supported client

Windows 2000 Professional, Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Wia.h

 

 

Community Additions

ADD
Show:
© 2015 Microsoft