IWiaItem2::EnumDeviceCapabilities method

Creates an enumerator that is used to ascertain the commands and events a Windows Image Acquisition (WIA) 2.0 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. It is one of the following values.

WIA_DEVICE_COMMANDS

Enumerate device commands.

WIA_DEVICE_EVENTS

Enumerate device events.

ppIEnumWIA_DEV_CAPS [out]

Type: IEnumWIA_DEV_CAPS**

Receives a pointer to the IEnumWIA_DEV_CAPS interface created by this method.

Return value

Type: HRESULT

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

Remarks

This method is used to create an enumerator object to obtain the set of commands and events that a WIA 2.0 device supports. The lFlags parameter is used to specify which kinds of device capabilities to enumerate. The IWiaItem2::EnumDeviceCapabilities method stores the address of the interface of the enumerator object in the ppIEnumWIA_DEV_CAPS parameter.

This method can only be called on the root item of IWiaItem2 objects of a device tree.

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 Vista [desktop apps only]
Minimum supported server	Windows Server 2008 [desktop apps only]
Header	Wia.h
IDL	Wia.idl