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

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

  • Статья

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

Синтаксис

HRESULT Next(
  [in]  ULONG        celt,
  [out] IMDSPStorage **ppStorage,
  [out] ULONG        *pceltFetched
);

Параметры

[in] celt

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

[out] ppStorage

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

[out] pceltFetched

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

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

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

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

Комментарии

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

Перечислитель хранилища может не отражать эффект вставки и удаления мультимедиа. В таких случаях клиент должен получить новый объект перечислителя.

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

Требования

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

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

Интерфейс IMDSPEnumStorage

Интерфейс IMDSPStorage

Интерфейс IWMDMStorage