IUPnPDescriptionDocument::RootDevice method (upnp.h)
The RootDevice method returns the root device of the currently loaded document's device tree.
Syntax
HRESULT RootDevice(
[out] IUPnPDevice **ppudRootDevice
);
Parameters
[out] ppudRootDevice
Receives a reference to an IUPnPDevice object that describes the device. This reference must be released when it is no longer required.
Return value
If the method succeeds, the return value is S_OK. Otherwise, the method returns one of the COM error codes defined in WinError.h.
Remarks
Do not use RootDevice unless a device description is first loaded using either IUPnPDescriptionDocument::Load or IUPnPDescriptionDocument::LoadAsync. The search operation only searches in the currently loaded device description.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows XP [desktop apps only] |
| Minimum supported server | None supported |
| Target Platform | Windows |
| Header | upnp.h |
| DLL | Upnp.dll |