IWiaItem::EnumDeviceCapabilities method

The IWiaItem::EnumDeviceCapabilities method creates an enumerator that is used to ascertain the commands and events a Windows Image Acquisition (WIA) device supports.

Syntax


HRESULT EnumDeviceCapabilities(
  [in]  LONG              lFlags,
  [out] IEnumWIA_DEV_CAPS **ppIEnumWIA_DEV_CAPS
);

Parameters

lFlags [in]

Type: LONG

Specifies a flag that selects the type of capabilities to enumerate. Can be set to one or more of the following values:

FlagMeaning
WIA_DEVICE_COMMANDSEnumerate device commands.
WIA_DEVICE_EVENTSEnumerate device events.

 

ppIEnumWIA_DEV_CAPS [out]

Type: IEnumWIA_DEV_CAPS**

Pointer to IEnumWIA_DEV_CAPS interface created by IWiaItem::EnumDeviceCapabilities.

Return value

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

Use this method to create an enumerator object to obtain the set of commands and events that a WIA device supports. You can use the lFlags parameter to specify which kinds of device capabilities to enumerate. The IWiaItem::EnumDeviceCapabilities method stores the address of the interface of the enumerator object in the ppIEnumWIA_DEV_CAPS parameter.

Applications must call the IUnknown::Release method on the interface pointers they receive through the ppIEnumWIA_DEV_CAPS parameter.

Requirements

Minimum supported client

Windows 2000 Professional, Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Wia.h

Library

Wiaguid.lib

DLL

Wiaservc.dll

 

 

Show: