IUPnPDescriptionDocument：：RootDevice 方法 (upnp.h)

RootDevice 方法返回当前加载的文档的设备树的根设备。

语法

HRESULT RootDevice(
  [out] IUPnPDevice **ppudRootDevice
);

[out] ppudRootDevice

接收对描述设备的 IUPnPDevice 对象的引用。当不再需要此引用时，必须释放该引用。

如果方法成功，则返回值S_OK。否则，方法将返回 WinError.h 中定义的 COM 错误代码之一。

除非首先使用 IUPnPDescriptionDocument：：Load 或 IUPnPDescriptionDocument：：LoadAsync 加载设备说明，否则请勿使用 RootDevice。搜索操作仅在当前加载的设备说明中搜索。