Symbian^3 Application Developer Library >

MBluetoothSynchronousLinkNotifier Class Reference

class MBluetoothSynchronousLinkNotifier

SCO and eSCO link notification events.

This allows for notification of Connect, Disconnect, Send and Receive events relating to SCO and eSCO links.

Mixin class to be used with CBluetoothSynchronousLink Note that although the function signatures allow it, these functions should not be allowed to leave as the error will be ignored.

Public Member Functions
void HandleAcceptConnectionCompleteL ( TInt )
void HandleDisconnectionCompleteL ( TInt )
void HandleReceiveCompleteL ( TInt )
void HandleSendCompleteL ( TInt )
void HandleSetupConnectionCompleteL ( TInt )
IMPORT_C void MBSLN_ExtensionInterfaceL ( TUid , void *&)

Member Functions Documentation

HandleAcceptConnectionCompleteL(TInt)

void HandleAcceptConnectionCompleteL ( TInt aErr ) [pure virtual]

Notification that a synchronous link (SCO) has been accepted

If no error is reported, then we have accepted a request for a synchronous link. That synchronous link is ready for use.
Note:

1) Observe that although the function signature allows it, this function should not be allowed to leave as the error will be ignored.

2) The implementation of this function should NOT be used to delete the associated CBluetoothSynchronousLink object.

Parameters

TInt aErr the returned error

HandleDisconnectionCompleteL(TInt)

void HandleDisconnectionCompleteL ( TInt aErr ) [pure virtual]

Notification that a synchronous link (SCO) has disconnected

If no error is reported, then the synchronous link has been closed.
Note:

1) Observe that although the function signature allows it, this function should not be allowed to leave as the error will be ignored.

2) The implementation of this function should NOT be used to delete the associated CBluetoothSynchronousLink object.

Parameters

TInt aErr the returned error

HandleReceiveCompleteL(TInt)

void HandleReceiveCompleteL ( TInt aErr ) [pure virtual]

Notification of a receive complete event

If no error is reported, then then we have successfully received a specified quantity of synchronous (SCO) data.
Note:

1) Observe that although the function signature allows it, this function should not be allowed to leave as the error will be ignored.

2) The implementation of this function should NOT be used to delete the associated CBluetoothSynchronousLink object.

Parameters

TInt aErr the returned error

HandleSendCompleteL(TInt)

void HandleSendCompleteL ( TInt aErr ) [pure virtual]

Notification of a send complete event

If no error is reported, then an attempt to send synchronous (SCO) data (e.g. voice) over Bluetooth has succeeded.
Note:

1) Observe that although the function signature allows it, this function should not be allowed to leave as the error will be ignored.

2) The implementation of this function should NOT be used to delete the associated CBluetoothSynchronousLink object.

Parameters

TInt aErr the returned error

HandleSetupConnectionCompleteL(TInt)

void HandleSetupConnectionCompleteL ( TInt aErr ) [pure virtual]

Notification that a synchronous link (SCO) has been set up

If no error is reported, then the synchronous link is ready for use.
Note:

1) Observe that although the function signature allows it, this function should not be allowed to leave as the error will be ignored.

2) The implementation of this function should NOT be used to delete the associated CBluetoothSynchronousLink object.

Parameters

TInt aErr the returned error

MBSLN_ExtensionInterfaceL(TUid, void *&)

IMPORT_C void MBSLN_ExtensionInterfaceL ( TUid aInterface,
void *& aObject
) [virtual]

Returns a null aObject if the extension is not implemented, or a pointer to another interface if it is. This virtual function allows the M- class to be extended in future in a binary compatible way by providing a method that clients can override in future to allow extra callbacks to be made via aObject.

Parameters

TUid aInterface UID of the interface to return
void *& aObject the container for another interface as specified by aInterface

Copyright ©2010 Nokia Corporation and/or its subsidiary(-ies).
All rights reserved. Unless otherwise stated, these materials are provided under the terms of the Eclipse Public License v1.0.