IMDSPEnumStorage::Next 方法 (mswmdm.h)

Next 方法返回指向下一个 celtIMDSPStorage 接口的指针。

语法

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 错误代码
  • 转换为 HRESULT 值的 Windows 错误代码
  • Windows Media 设备管理器错误代码
有关可能错误代码的广泛列表,请参阅 错误代码

注解

如果没有更多的存储接口,或者存储接口少于请求的存储接口,则“ 下一步 ”的返回值S_FALSE。 发生这种情况时,必须查询 pceltFetched 参数以确定返回了多少个接口(如果有)。

存储枚举器可能不会反映媒体插入和移除的效果。 在这种情况下,客户端应获取新的枚举器对象。

必须实现此方法。 它不得返回WMDM_E_NOTSUPPORTED或E_NOTIMPL。 有关详细信息,请参阅 必需接口和可选接口

要求

要求
目标平台 Windows
标头 mswmdm.h
Library Mssachlp.lib

另请参阅

IMDSPEnumStorage 接口

IMDSPStorage 接口

IWMDMStorage 接口