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 |
|
| IDL |
|