Skip to content

Latest commit

 

History

History
107 lines (63 loc) · 2.98 KB

-wia-iwiaitem2-enumdevicecapabilities.md

File metadata and controls

107 lines (63 loc) · 2.98 KB
description ms.assetid title ms.topic ms.date topic_type api_name api_type api_location
Creates an enumerator that is used to ascertain the commands and events a Windows Image Acquisition (WIA) 2.0 device supports.
9efb758d-a5d6-41c7-b318-2897274ccbc0
IWiaItem2::EnumDeviceCapabilities method (Wia.h)
reference
05/31/2018
APIRef
kbSyntax
IWiaItem2.EnumDeviceCapabilities
COM
Wia.h

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