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

另请参阅

IMDSPDevice 接口

IMDSPEnumDevice 接口