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 |