IWiaItem::EnumDeviceCapabilities method (wia_xp.h)

Article
10/13/2021

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

[in] lFlags

Type: LONG

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

Flag	Meaning
WIA_DEVICE_COMMANDS	Enumerate device commands.
WIA_DEVICE_EVENTS	Enumerate device events.

[out] ppIEnumWIA_DEV_CAPS

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

Requirement	Value
Minimum supported client	Windows 2000 Professional, Windows XP [desktop apps only]
Minimum supported server	Windows Server 2003 [desktop apps only]
Target Platform	Windows
Header	wia_xp.h (include Wia.h)
Library	Wiaguid.lib
DLL	Wiaservc.dll

Share via