bluetoothengine/bthid/bthidserver/inc/hidsdpclient.h
author Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
Mon, 15 Mar 2010 12:41:15 +0200
branchRCL_3
changeset 9 a42ed326b458
parent 0 f63038272f30
permissions -rw-r--r--
Revision: 201009 Kit: 201010

/*
* Copyright (c) 2008 Nokia Corporation and/or its subsidiary(-ies).
* All rights reserved.
* This component and the accompanying materials are made available
* under the terms of "Eclipse Public License v1.0"
* which accompanies this distribution, and is available
* at the URL "http://www.eclipse.org/legal/epl-v10.html".
*
* Initial Contributors:
* Nokia Corporation - initial contribution.
*
* Contributors:
*
* Description:  Declares main application class.
 *
*/


#ifndef __HIDSDPCLIENT_H__
#define __HIDSDPCLIENT_H__

#include <e32base.h>
#include <btsdp.h>

class CBTHidDevice;
class MHidSdpObserver;

/*!
 This class queries the SDP database of a HID device in order to populate an
 instance of the CBTHidDevice class
 */
class CHidSdpClient : public CActive, public MSdpAgentNotifier
    {
public:

    /*!
     Create a CHidSdpClient object
     @param aDevice device details object to populate
     @param aObserver observer to report to.
     @result A pointer to the created instance of CHidSdpClient
     */
    static CHidSdpClient* NewL(CBTHidDevice& aDevice,
            MHidSdpObserver& aObserver);

    /*!
     Create a CHidSdpClient object
     @param aDevice device details object to populate
     @param aObserver observer to report to.
     @result A pointer to the created instance of CHidSdpClient
     */
    static CHidSdpClient* NewLC(CBTHidDevice& aDevice,
            MHidSdpObserver& aObserver);

    /*!
     Destroy the object and release all memory objects
     */
    ~CHidSdpClient();

    /*!
     Start the SDP inquiry.
     */
    void StartL();

    /*!
     Ask the object to destroy itself when its conventient.
     */
    void Kill();

public:
    // From CActive
    void RunL()
        {
        delete this;
        }
    ;
    void DoCancel()
        {
        }
    ;

public:
    // From MSdpAgentNotifier
    /*!
     Called when an service record request 
     (CSdpAgent::NextRecordRequestComplete()) operation completes.
     @param aError KErrNone, or an SDP error
     @param aHandle Service record for which the query was made
     @param aTotalRecordsCount Total number of matching records
     */

    void NextRecordRequestComplete(TInt aError, TSdpServRecordHandle aHandle,
            TInt aTotalRecordsCount);
    /*!
     Called by the attribute request function 
     (CSdpAgent::AttributeRequestL()) to pass the results of a successful 
     attribute request.
     @param aHandle Service record for which the query was made
     @param aAttrID ID of the attribute obtained
     @param aAttrValue Attribute value obtained
     */

    void AttributeRequestResult(TSdpServRecordHandle aHandle,
            TSdpAttributeID aAttrID, CSdpAttrValue* aAttrValue);

    /*!
     Called when an service record request 
     (CSdpAgent::NextRecordRequestComplete()) operation completes.
     @param aHandle Service record for which the query was made
     @param aError KErrNone, or an SDP error
     */

    void AttributeRequestComplete(TSdpServRecordHandle aHandle, TInt aError);

private:

    /*!
     Constructs this object
     @param aDevice device details object to populate
     @param aObserver observer to report to.
     */
    CHidSdpClient(CBTHidDevice& aDevice, MHidSdpObserver& aObserver);

    /*!
     Performs second phase construction of this object
     */
    void ConstructL();

    /*
     Reset the object and inform the observer of the result
     @param aError KErrNone if successful, or an SDP error
     */
    void Finish(TInt aError);

private:
    // Member variables
    /*! Current Parser State */
    enum TParserState
        {
        EIdle, /*!< Parser is idle */
        EHIDService, /*!< Parser is retrieving the HID Service Record */
        EBTPnPService
        /*!< Parser is retrieving the PnP Service Record */
        };

    /*! Device details object to fill from sdp query */
    CBTHidDevice& iDevice;

    /*! Observer to inform of results */
    MHidSdpObserver& iObserver;

    /*! Current state of the parser */
    TParserState iParserState;

    /*! SDP Agent used to search the SDP database */
    CSdpAgent* iAgent;

    /*! UUID pattern to filter the SDP database search */
    CSdpSearchPattern* iSdpSearchPattern;

    /*! HID Service record attribute filter */
    CSdpAttrIdMatchList* iHIDMatchList;

    /*! BT PnP Service record attribute filter */
    CSdpAttrIdMatchList* iPNPMatchList;

    /*! A bitmask of the mandatory  attributes found */
    TUint iMandAttrValue;
    };

#endif // __HIDSDPCLIENT_H__