IMDSPEnumDevice::Next 方法 (mswmdm.h)
Next 方法检索指向下一个 celtIMDSPDevice 接口的指针。
语法
HRESULT Next(
[in] ULONG celt,
[out] IMDSPDevice **ppDevice,
[out] ULONG *pceltFetched
);
参数
[in] celt
请求的设备数。
[out] ppDevice
由调用方分配的 celt 指针 的数组 IMDSPDevice 。 返回 NULL 以指示不存在更多设备或发生了错误。 如果 celt 大于 1,则调用方必须分配足够的内存来存储 celt 数量的接口指针。
[out] pceltFetched
指向 ULONG 变量的指针,该变量接收检索到的接口数。
返回值
该方法返回 HRESULT。 Windows Media 设备管理器 中的所有接口方法都可以返回以下任一类错误代码:
- 标准 COM 错误代码
- 转换为 HRESULT 值的 Windows 错误代码
- Windows Media 设备管理器错误代码
注解
如果枚举设备没有更多的服务提供程序接口,或者这些接口少于 celt 参数请求的接口,则 Next 的返回值S_FALSE。 发生这种情况时,必须查询 pceltFetched 参数以确定返回了多少个接口(如果有)。
设备枚举器可能无法反映设备插入和移除的效果。
必须实现此方法。 它不得返回WMDM_E_NOTSUPPORTED或E_NOTIMPL。 有关详细信息,请参阅 必需接口和可选接口。
要求
要求 | 值 |
---|---|
目标平台 | Windows |
标头 | mswmdm.h |
Library | Mssachlp.lib |