IEnumWIA_DEV_INFO::Next method

The IEnumWIA_DEV_INFO::Next method fills an array of pointers to IWiaPropertyStorage interfaces.

Syntax


HRESULT Next(
  [in]              ULONG               celt,
  [out]             IWiaPropertyStorage **rgelt,
  [in, out, unique] ULONG               *pceltFetched
);

Parameters

celt [in]

Type: ULONG

Specifies the number of array elements in the array indicated by the rgelt parameter.

rgelt [out]

Type: IWiaPropertyStorage**

Receives the address of an array of IWiaPropertyStorage interface pointers. IEnumWIA_DEV_INFO::Next fills this array with interface pointers.

pceltFetched [in, out]

Type: ULONG*

On output, this parameter contains the number of interface pointers actually stored in the array indicated by the rgelt parameter.

Return value

Type: HRESULT

While there are devices left to enumerate, this method returns S_OK. It returns S_FALSE when the enumeration is finished. If the method fails, it returns a standard COM error code.

Remarks

Applications use this method to query the properties of each available Windows Image Acquisition (WIA) hardware device. To do so, the application passes an array of IWiaPropertyStorage interface pointers that it allocates. It also passes the number of array elements in the parameter celt. The IEnumWIA_DEV_INFO::Next method fills the array with pointers to IWiaPropertyStorage interfaces. Applications can query the interfaces for the properties that the device supports.

Applications must call the IUnknown::Release method on the interface pointers they receive through the rgelt 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

 

 

Show: