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

Метод IMDSPEnumDevice::Next (mswmdm.h)

  • Статья

Метод Next извлекает указатель на интерфейсы celtIMDSPDevice .

Синтаксис

HRESULT Next(
  [in]  ULONG       celt,
  [out] IMDSPDevice **ppDevice,
  [out] ULONG       *pceltFetched
);

Параметры

[in] celt

Количество запрошенных устройств.

[out] ppDevice

Массив указателей celtIMDSPDevice , выделенных вызывающим объектом. Возвращает значение NULL , чтобы указать, что больше устройств не существует или произошла ошибка. Если значение celt больше 1, вызывающий объект должен выделить достаточно памяти для хранения количества указателей интерфейса celt .

[out] pceltFetched

Указатель на переменную ULONG , которая получает количество извлеченных интерфейсов.

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

Метод возвращает HRESULT. Все методы интерфейса в Windows Media диспетчер устройств могут возвращать любой из следующих классов кодов ошибок:

  • Стандартные коды ошибок COM
  • Коды ошибок Windows, преобразованные в значения HRESULT
  • Коды ошибок диспетчер устройств Windows Media
Подробный список возможных кодов ошибок см. в разделе Коды ошибок.

Комментарии

Если интерфейсов поставщика услуг для перечисленных устройств не больше или их меньше, чем запрошено параметром celt , возвращается значение next S_FALSE. В этом случае необходимо запросить параметр pceltFetched , чтобы определить, сколько интерфейсов ( если таковые есть) были возвращены.

Перечислитель устройств может не отражать эффект вставки и удаления устройства.

Этот метод должен быть реализован. Он не должен возвращать WMDM_E_NOTSUPPORTED или E_NOTIMPL. Дополнительные сведения см. в разделе Обязательные и необязательные интерфейсы.

Требования

Требование Значение
Целевая платформа Windows
Header mswmdm.h
Библиотека Mssachlp.lib

См. также раздел

Интерфейс IMDSPDevice

Интерфейс IMDSPEnumDevice