RDevice Class Reference

#include <e32std.h>

class RDevice : public RHandleBase

Inherits from

Detailed Description

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.

Member Function Documentation

GetCaps ( TDes8 & )

IMPORT_C voidGetCaps(TDes8 &aDes)const

Gets the device capabilities.

Parameters
aDesA descriptor into which capability's information is to be written.

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

IMPORT_C TBoolIsAvailable(TIntaUnit,
const TDesC *aPhysicalDevice,
const TDesC8 *anInfo
)const

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

Parameters
aUnitThe requested unit number.
aPhysicalDeviceThe requested PDD name.
anInfoThe additional information.
Return Value
ETrue if supported, EFalse if not.

Open ( const TFindLogicalDevice &, TOwnerType )

TInt Open(const TFindLogicalDevice &aFind,
TOwnerTypeaType = 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
aFindA reference to the object which is used to find the LDD factory object.
aTypeAn enumeration whose enumerators define the ownership of this LDD factory object handle. If not explicitly specified, EOwnerProcess is taken as default.
Return Value
KErrNone if successful, otherwise one of the other system wide error codes.

Open ( const TDesC &, TOwnerType )

IMPORT_C TIntOpen(const TDesC &aName,
TOwnerTypeaType = EOwnerProcess
)

Opens a handle to an LDD factory object by name.

Parameters
aNameThe name of the LDD factory object to be opened.
aTypeAn enumeration whose enumerators define the ownership of this LDD factory object handle.
Return Value
KErrNone, if successful; otherwise one of the other system wide error codes.

QueryVersionSupported ( const TVersion & )

IMPORT_C TBoolQueryVersionSupported(const TVersion &aVer)const

Checks if a device supports a particular version.

Parameters
aVerThe requested device version.
Return Value
ETrue if supported, EFalse if not.