bluetoothdevicediscoverer.h

基于symbian UIQ 的一款古老的飞机游戏。对入门学习很有帮助。

/*
============================================================================
 Name			: BlueToothDeviceDiscoverer.h
 Author	  		: 
 Copyright   	: 
 Description 	: CBluetoothDeviceDiscoverer is responsible for displaying to the player (Master role) the available
				  BT devices in range from which they can choose. CBluetoothDeviceDiscoverer is implemented using the
				  CQBTUISelectDialog dialog.
============================================================================
*/

#ifndef __BLUETOOTHDEVICEDISCOVERER_H__
#define __BLUETOOTHDEVICEDISCOVERER_H__

// INCLUDES
#include <bt_sock.h>
#include <btmanclient.h>
#include <qbtselectdlg.h>
#include <btextnotifiers.h>
#include <btsdp.h>
#include "commoninterfaces.h"

// CLASS DECLARATION
/**
* CBluetoothDeviceDiscoverer
* Displays to the player the BT device in range to choose from
*/
class CBluetoothDeviceDiscoverer : public CActive
    {
public:
	/**
	* Constructor
	* @param aObs	Device discovery observer
	*/
    CBluetoothDeviceDiscoverer(MBluetoothDeviceDiscovererObserver& aObs);
    
	/**
	* Destructor
	*/
    ~CBluetoothDeviceDiscoverer();
    
	/**
	* Display the BT device in range for the player to choose from
	* @param aSelectionFilter	pckgbuf to send paramaters to the device selection dialog via the CQBTUISelectDialog framework
	*/
    void DiscoverAndSelectDeviceL(const TBTDeviceSelectionParamsPckg& aSelectionFilter);
private:
    //From CActive
	/**
	* Handles CBluetoothDeviceDiscoverer's completion events
	*/
    void RunL();
    
	/**
	* Cancels an oustanding Notifier request
	*/
    void DoCancel();
    
	/**
	* Handles a leave occurring in the request completion event handler RunL()
	* @param aError	 The leave code
	* @return TInt	 The default implementation returns aError.A derived class implementation should return KErrNone,
	*				 if it handles the leave; otherwise it should return any suitable value to cause the handling
	*				 of the error to be propagated back to the active scheduler.
	*/
	virtual TInt RunError(TInt aError);
private:
	/**
	* The reference to the device discoverer observer
	*/
	MBluetoothDeviceDiscovererObserver& iObserver;
		
	/**
	* Pckgbuf to retrieve the response from the device CQBTUISelectDialog selection dialog
	*/
	TBTDeviceResponseParamsPckg iResponse;
    };

#endif // __BLUETOOTHDEVICEDISCOVERER_H__