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

另请参阅

枚举设备

IMDServiceProvider 接口