IMDServiceProvider2::CreateDevice 方法 (mswmdm.h)
CreateDevice 方法由 Windows 媒体设备管理器调用,以获取与从 PnP 子系统获取的规范设备相对应的 IMDSPDevice 对象 () 。 必须实现此方法才能支持 PnP 和 Windows 资源管理器,否则它是可选的。 有关详细信息,请参阅 必需接口和可选接口。
语法
HRESULT CreateDevice(
[in] LPCWSTR pwszDevicePath,
[out] DWORD *pdwCount,
[out] IMDSPDevice ***pppDeviceArray
);
参数
[in] pwszDevicePath
指向包含 Windows Media 设备管理器检测到的设备路径的宽字符 null 终止字符串的指针。 此名称是从 PnP 子系统获取的,是规范名称加上“$ # ”,其中 # 是自动递增数字。 此名称可以直接传递给 CreateFile 等函数,以获取对基础内核设备对象的访问权限。 服务提供商应为此设备创建包装 IMDSPDevice 对象 () 。
[out] pdwCount
指向包含所创建 IMDSPDevice 对象数的 DWORD 的指针。
[out] pppDeviceArray
表示设备的 IMDSPDevice 接口数组。 通常,只有一个数组元素,但如果服务提供商为每个顶级存储创建 IMDSPDevice 对象,则服务提供程序可以创建多个对应于设备路径名称的 IMDSPDevice 对象。 这在将来可能会更改,计数可能限制为 1。
返回值
如果方法成功,则返回S_OK。 如果方法失败,它将返回 Windows Media 设备管理器错误代码。
注解
Windows Media 设备管理器在应用程序启动时或即插即用兼容设备与计算机连接时调用此方法。
要求
要求 | 值 |
---|---|
目标平台 | Windows |
标头 | mswmdm.h |
Library | Mssachlp.lib |