Symbian Developer Library

SYMBIAN OS V6.1 EDITION FOR C++

[Index] [Glossary] [Previous] [Next]



Location: ir_sock.h
Link against: irda.lib

Class TIrdaSockAddr

TIrdaSockAddr

Support

Supported from 5.0

Description

An IrDA socket address.

Derivation

TBuf8This is a descriptor class which provides a buffer of fixed length for containing, accessing and manipulating TUint8 data
TBufBase8Base class used in the derivation of TBuf8
TDes8Modifiable 8-bit descriptor; abstract class
TDesC8Abstract base class for 8 bit non-modifiable descriptors
TIrdaSockAddrAn IrDA socket address
TSockAddrRepresents an end point address

Defined in TIrdaSockAddr:
Cast(), GetCharacterSet(), GetFirstServiceHintByte(), GetHostDevAddr(), GetIrlapVersion(), GetRemoteDevAddr(), GetSecondServiceHintByte(), GetServiceHintByteCount(), GetSniffStatus(), GetSolicitedStatus(), SetCharacterSet(), SetFirstServiceHintByte(), SetHostDevAddr(), SetIrlapVersion(), SetRemoteDevAddr(), SetSecondServiceHintByte(), SetServiceHintByteCount(), SetSniffStatus(), SetSolicitedStatus(), TIrdaSockAddr()

Inherited from TBuf8:
operator=()

Inherited from TDes8:
Append(), AppendFill(), AppendFormat(), AppendFormatList(), AppendJustify(), AppendNum(), AppendNumFixedWidth(), AppendNumFixedWidthUC(), AppendNumUC(), Capitalize(), Collate(), Copy(), CopyC(), CopyCP(), CopyF(), CopyLC(), CopyUC(), Delete(), Fill(), FillZ(), Fold(), Format(), FormatList(), Insert(), Justify(), LowerCase(), MaxLength(), MaxSize(), Num(), NumFixedWidth(), NumFixedWidthUC(), NumUC(), PtrZ(), Repeat(), Replace(), SetLength(), SetMax(), Swap(), Trim(), TrimAll(), TrimLeft(), TrimRight(), UpperCase(), Zero(), ZeroTerminate(), operator+=(), operator=, operator[]()

Inherited from TDesC8:
Alloc(), AllocL(), AllocLC(), Compare(), CompareC(), CompareF(), Find(), FindC(), FindF(), Left(), Length(), Locate(), LocateF(), LocateReverse(), LocateReverseF(), Match(), MatchC(), MatchF(), Mid(), Ptr(), Right(), Size(), operator!=(), operator<(), operator<=(), operator==(), operator>(), operator>=()

Inherited from TSockAddr:
CmpPort(), Family(), GetUserLen(), Port(), SetFamily(), SetPort(), SetUserLen(), UserPtr()


Construction


TIrdaSockAddr()

TIrdaSockAddr();

Description

Default constructor. Sets the protocol family to the value of the constant KIrdaAddrFamily.


TIrdaSockAddr()

TIrdaSockAddr(const TSockAddr& aAddr);

Description

Copy constructor. Assumes that the source address is an IrDA socket address.

Parameters

const TSockAddr& aAddr

A socket address assumed to be valid IrDA socket address.

[Top]


Cast


Cast()

static TIrdaSockAddr& Cast(const TSockAddr& aAddr);
static TIrdaSockAddr& Cast(const TSockAddr* aAddr);

Description

Casts a general socket address into an IrDA socket address.

Parameters

const TSockAddr& aAddr

A reference to a general socket address.

const TSockAddr* aAddr

A pointer to a general socket address.

Return value

TIrdaSockAddr&

The socket address returned as a reference to an IrDA socket address.

[Top]


Retrieve device information


GetHostDevAddr()

TUint GetHostDevAddr() const;

Description

Returns the host device address.

Return value

TUint

The host device address as a 32 bit value.


GetRemoteDevAddr()

TUint GetRemoteDevAddr() const;

Description

Returns the remote device address.

Return value

TUint

The remote device address as a 32 bit value.


GetCharacterSet()

TUint8 GetCharacterSet() const;

Description

Returns the character set supported by the remote device.

Return value

TUint8

One of the TIASCharSet enumerator values defining the character set supported by the device.


GetServiceHintByteCount()

TUint8 GetServiceHintByteCount() const;

Description

Returns the number of service hint bytes for the remote device.

Return value

TUint8

The number of service hint bytes.


GetFirstServiceHintByte()

TUint8 GetFirstServiceHintByte() const;

Description

Returns the remote device's first service hint byte. Service hint bytes indicate the level of IrLMP support provided by the device.

Return value

TUint8

The first service hint byte. The individual bits have the following meaning: Bit 0 (0x01) - PnP Compatible Bit 1 (0x02) - PDA/Palmtop Bit 2 (0x04) - Computer Bit 3 (0x08) - Printer Bit 4 (0x10) - Modem Bit 5 (0x20) - Fax Bit 6 (0x40) - LAN Access Bit 7 (0x80) - Extension


GetSecondServiceHintByte()

TUint8 GetSecondServiceHintByte() const;

Description

Returns the remote device's first service hint byte. Service hint bytes indicate the level of IrLMP support provided by the device.

Return value

TUint8

The second service hint byte. The individual bits have the following meaning: Bit 0 (0x01) - Telephony Bit 1 (0x02) - File Server Bit 2 (0x04) - IrCOMM Bit 3 (0x08) - reserved Bit 4 (0x10) - reserved Bit 5 (0x20) - IrOBEX Bit 6 (0x40) - reserved Bit 7 (0x80) - Extension


GetIrlapVersion()

TUint8 GetIrlapVersion() const;

Description

Returns the remote device's IrLAP version number.

This should be 0x00 indicating that the device conforms to the IrDA IrLAP 1.00 specification.

Return value

TUint8

The device's IrLAP version number.


GetSniffStatus()

TBool GetSniffStatus() const;

Description

Returns the remote device's sniff status, i.e. whether the device is capable of ‘sniffing’ for IrDA devices.

Return value

TBool

True, if the device is capable of sniffing for IrDA devices; false, otherwise.


GetSolicitedStatus()

TBool GetSolicitedStatus() const;

Description

Returns the solicited status.

The solicited status indicates whether a discovery was initiated by the host device or a remote device.

Return value

TBool

True, if the discovery was initiated by the host device; false if the discovery was initiated by the remote device.

[Top]


Set device information


SetHostDevAddr()

void SetHostDevAddr(const TUint aHost);

Description

Sets the host device address.

Parameters

const TUint aHost

The host device address as a 32-bit value.


SetRemoteDevAddr()

void SetRemoteDevAddr(const TUint aRemote);

Description

Sets the remote device address.

Parameters

const TUint aRemote

The remote device address as a 32-bit value.


SetCharacterSet()

void SetCharacterSet(const TUint8 aCharacterSet);

Description

Sets the character set supported by the remote device.

Parameters

const TUint8 aCharacterSet

One of the TIASCharSet enumerator values defining the character set supported by the device


SetServiceHintByteCount()

void SetServiceHintByteCount(const TUint8 aServiceHintByteCount);

Description

Sets the number of service hint bytes for the remote device.

Parameters

const TUint8 aServiceHintByteCount

The number of service hint bytes.


SetFirstServiceHintByte()

void SetFirstServiceHintByte(const TUint8 aFirstServiceHintByte);

Description

Sets the first service hint byte for the remote device. The service hint bytes indicate the level of IrLMP support provided by the device.

Parameters

const TUint8 aFirstServiceHintByte

The first service hint byte. The individual bits have the following meaning: Bit 0 (0x01) - PnP Compatible Bit 1 (0x02) - PDA/Palmtop Bit 2 (0x04) - Computer Bit 3 (0x08) - Printer Bit 4 (0x10) - Modem Bit 5 (0x20) - Fax Bit 6 (0x40) - LAN Access Bit 7 (0x80) - Extension


SetSecondServiceHintByte()

void SetSecondServiceHintByte(const TUint8 aSecondServiceHintByte);

Description

Sets the second service hint byte for the remote device. The service hint bytes indicate the level of IrLMP support provided by the device.

Parameters

const TUint8 aSecondServiceHintByte

The second service hint byte. The individual bits have the following meaning: Bit 0 (0x01) - Telephony Bit 1 (0x02) - File Server Bit 2 (0x04) - IrCOMM Bit 3 (0x08) - reserved Bit 4 (0x10) - reserved Bit 5 (0x20) - IrOBEX Bit 6 (0x40) - reserved Bit 7 (0x80) - Extension


SetIrlapVersion()

void SetIrlapVersion(const TUint8 aIrlapVersion);

Description

Sets the IrLAP version number for the remote device.

This should be 0x00 indicating that the device conforms to the IrDA IrLAP 1.00 specification.

Parameters

const TUint8 aIrlapVersion

The device's IrLAP version number.


SetSniffStatus()

void SetSniffStatus(const TBool aSniff);

Description

Sets the sniff status for the remote device, i.e. whether the device is capable of ‘sniffing’ for IrDA devices.

Parameters

const TBool aSniff

True, if the device is capable of sniffing for IrDA devices; false, otherwise.


SetSolicitedStatus()

void SetSolicitedStatus(const TBool aSolicited);

Description

Sets the solicited status. The solicited status indcates whether a discovery was initiated by the host device or a remote device.

Parameters

const TBool aSolicited

ETrue, if the discovery was initiated by the host device;EFalse, if discovery was initiated by the remote device.