IMDServiceProvider::EnumDevices 方法 (mswmdm.h)
EnumDevices 方法枚举已安装的物理或软件设备,这些物理或软件设备当前已附加并由服务提供商知道。
语法
HRESULT EnumDevices(
[out] IMDSPEnumDevice **ppEnumDevice
);
参数
[out] ppEnumDevice
指向 IMDSPEnumDevice 接口的 指针。 如果服务提供商实现 IMDServiceProvider2::CreateDevice,则此枚举器应仅枚举非即插即用设备。
返回值
该方法返回 HRESULT。 Windows Media 设备管理器 中的所有接口方法都可以返回以下任一类错误代码:
- 标准 COM 错误代码
- 转换为 HRESULT 值的 Windows 错误代码
- Windows Media 设备管理器错误代码
注解
此方法在未注册为即插即用感知的服务提供商上调用, (请参阅为设备启用 PnP 和枚举设备了解详细信息) 。 服务提供商应仅返回 枚举器,该枚举器将仅枚举当前附加到计算机并受服务提供商支持的设备。
仅当应用程序启动时或应用程序调用 IWMDeviceManager2::Reinitialize 时,才会调用此方法。
目前,Windows Media 设备管理器不支持退回已安装的设备。
当设备连接或断开计算机连接时,服务提供商无法向应用程序发出警报。 如果即插即用设备连接或断开连接,并且应用程序实现了 IWMDMNotification,则 Windows Media 设备管理器 将向应用程序发送通知。
必须实现此方法。 它不得返回WMDM_E_NOTSUPPORTED或E_NOTIMPL。 有关详细信息,请参阅 必需接口和可选接口。
要求
要求 | 值 |
---|---|
目标平台 | Windows |
标头 | mswmdm.h |
Library | Mssachlp.lib |