Поделиться через

Метод IEnumWIA_DEV_INFO::Next (wia_xp.h)

  • Статья

Метод IEnumWIA_DEV_INFO::Next заполняет массив указателей на интерфейсы IWiaPropertyStorage .

Синтаксис

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

Параметры

[in] celt

Тип: ULONG

Указывает количество элементов массива в массиве, указанное параметром rgelt .

[out] rgelt

Тип: IWiaPropertyStorage**

Получает адрес массива указателей интерфейса IWiaPropertyStorage . IEnumWIA_DEV_INFO::Next заполняет этот массив указателями интерфейса.

[in, out] pceltFetched

Тип: ULONG*

В выходных данных этот параметр содержит количество указателей интерфейса, фактически хранящихся в массиве, указанном параметром rgelt .

Возвращаемое значение

Тип: HRESULT

Хотя есть устройства для перечисления, этот метод возвращает S_OK. Он возвращает S_FALSE после завершения перечисления. Если метод завершается сбоем, он возвращает стандартный код ошибки COM.

Комментарии

Приложения используют этот метод для запроса свойств каждого доступного аппаратного устройства windows Image Acquisition (WIA). Для этого приложение передает массив указателей интерфейса IWiaPropertyStorage , которые оно выделяет. Он также передает количество элементов массива в параметре celt. Метод IEnumWIA_DEV_INFO::Next заполняет массив указателями на интерфейсы IWiaPropertyStorage . Приложения могут запрашивать у интерфейсов свойства, поддерживаемые устройством.

Приложения должны вызывать метод IUnknown::Release для указателей интерфейса, которые они получают через параметр rgelt .

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional, Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header wia_xp.h (включая Wia.h)
Библиотека Wiaguid.lib