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

Метод 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 Image Acquisition (WIA). Для этого приложение передает указатель на массив WIA_DEV_CAP структур, которые оно выделяет. Он также передает количество элементов массива в параметре celt. Метод IEnumWIA_DEV_CAPS::Next заполняет массив структурами. Затем приложения используют структуры для перечисления возможностей аппаратного устройства WIA.

Возможности устройства WIA определяются как события и команды, поддерживаемые устройством. Используя массив rgelt , IEnumWIA_DEV_CAPS::Next передает в приложение единую структуру для каждого события и команды, поддерживаемых устройством.

Обратите внимание, что IEnumWIA_DEV_CAPS::Next динамически выделяет WIA_DEV_CAP структуры, которые предоставляет приложениям. Поэтому приложения должны удалять WIA_DEV_CAP структуры, которые они получают с помощью параметра rgelt . Приложения должны использовать SysFreeString для освобождения полей bstrName, bstrDescription и bstrIcon всех WIA_DEV_CAP структур.

Требования

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