RDevice Class Reference

class RDevice : public RHandleBase

User side handle to an LDD factory object, an instance of a DLogicalDevice derived class.

The LDD factory object is a Kernel side object which is constructed on the Kernel heap when the logical device is opened using User::LoadLogicalDevice() . The handle allows the User side to get information about the logical device.

To use the device, a thread must create and use an instance of an RBusLogicalChannel derived class.

Inherits from

Member Functions Documentation

GetCaps(TDes8 &)

IMPORT_C void GetCaps ( TDes8 & aDes ) const

Gets the device capabilities.

Parameters

TDes8 & aDes A descriptor into which capability's information is to be written.

IsAvailable(TInt, const TDesC *, const TDesC8 *)

IMPORT_C TBool IsAvailable ( TInt aUnit,
const TDesC * aPhysicalDevice,
const TDesC8 * anInfo
) const

Checks if a specified unit number, additional info and a specific PDD is supported.

Parameters

TInt aUnit The requested unit number.
const TDesC * aPhysicalDevice The requested PDD name.
const TDesC8 * anInfo The additional information.

Open(const TFindLogicalDevice &, TOwnerType)

TInt Open ( const TFindLogicalDevice & aFind,
TOwnerType aType = EOwnerProcess
) [inline]

Opens a handle to an LDD factory object found using a TFindLogicalDevice object.

A TFindLogicalDevice object is used to find all LDD factory objects whose full names match a specified pattern.

Parameters

const TFindLogicalDevice & aFind A reference to the object which is used to find the LDD factory object.
TOwnerType aType = EOwnerProcess An enumeration whose enumerators define the ownership of this LDD factory object handle. If not explicitly specified, EOwnerProcess is taken as default.

Open(const TDesC &, TOwnerType)

IMPORT_C TInt Open ( const TDesC & aName,
TOwnerType aType = EOwnerProcess
)

Opens a handle to an LDD factory object by name.

Parameters

const TDesC & aName The name of the LDD factory object to be opened.
TOwnerType aType = EOwnerProcess An enumeration whose enumerators define the ownership of this LDD factory object handle.

QueryVersionSupported(const TVersion &)

IMPORT_C TBool QueryVersionSupported ( const TVersion & aVer ) const

Checks if a device supports a particular version.

Parameters

const TVersion & aVer The requested device version.