IWiaDataTransfer::idtEnumWIA_FORMAT_INFO method (wia_xp.h)

The IWiaDataTransfer::idtEnumWIA_FORMAT_INFO method creates a banded transfer implementation of the IEnumWIA_FORMAT_INFO interface.

Syntax

HRESULT idtEnumWIA_FORMAT_INFO(
  [out] IEnumWIA_FORMAT_INFO **ppEnum
);

Parameters

[out] ppEnum

Type: IEnumWIA_FORMAT_INFO**

Receives the address of a pointer to the IEnumWIA_FORMAT_INFO interface.

Return value

Type: HRESULT

If it fails for any reason other than those specified in the following table, this method will return a standard COM error.

Return Value Meaning
E_INVALIDARG The ppEnum parameter is not the address of a pointer to the IEnumWIA_FORMAT_INFO interface.
E_OUTOFMEMORY There is not enough memory to create the enumerator object.
S_OK The enumerator object was successfully created.

Remarks

This method creates the IEnumWIA_FORMAT_INFO interface that applications use to enumerate an array of WIA_FORMAT_INFO structures. This provides applications with the ability to determine the formats and media types of incoming data when transferring banded data.

Note that applications must call IUnknown::Release method on the interface pointers they receive through the ppEnum 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