IEnumWIA_DEV_CAPS：：Next 方法 (wia_xp.h)

IEnumWIA_DEV_CAPS：：Next 方法填充指向WIA_DEV_CAP结构的指针数组。

语法

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

参数

[in] celt

类型： ULONG

指定 由 rgelt 参数指示的数组中的数组元素数。

[out] rgelt

类型： WIA_DEV_CAP*

指向WIA_DEV_CAP结构的数组 的 指针。 IEnumWIA_DEV_CAPS：：Next 填充此结构数组。

[in, out] pceltFetched

类型： ULONG*

输出时，此参数包含 实际存储在 rgelt 参数指示的数组中的结构指针数。

返回值

类型： HRESULT

如果该方法成功，则返回 S_OK。 否则，将返回 HRESULT 错误代码。

注解

应用程序使用此方法查询每个可用的 Windows 映像采集 (WIA) 硬件设备的功能。 为此，应用程序将指针传递给它分配的 WIA_DEV_CAP 结构的数组。 它还传入参数 celt 中的数组元素数。 IEnumWIA_DEV_CAPS：：Next 方法使用 结构填充数组。 然后，应用程序使用这些结构枚举 WIA 硬件设备功能。

WIA 设备功能定义为设备支持的事件和命令。 使用 rgelt 数组， IEnumWIA_DEV_CAPS：：Next 为设备支持的每个事件和命令将单个结构传递给应用程序。

请注意， IEnumWIA_DEV_CAPS：：Next 会动态分配它提供给应用程序的 WIA_DEV_CAP 结构。 因此，应用程序必须删除通过 rgelt 参数接收的WIA_DEV_CAP结构。 应用程序应使用 SysFreeString 释放所有WIA_DEV_CAP结构的 bstrName、bstrDescription 和 bstrIcon 字段。

要求