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

See also

IUPnPDescriptionDocument

IUPnPDevice