//
// Copyright (c) Microsoft Corporation.  All rights reserved.
//
//
// Use of this source code is subject to the terms of the Microsoft end-user
// license agreement (EULA) under which you licensed this SOFTWARE PRODUCT.
// If you did not accept the terms of the EULA, you are not authorized to use
// this source code. For a copy of the EULA, please see the LICENSE.RTF on your
// install media.
//
//------------------------------------------------------------------------------
// 
//      Bluetooth client API declarations
// 
// 
// Module Name:
// 
//      bt_api.h
// 
// Abstract:
// 
//      This file defines client-level APIs to Bluetooth stack
// 
// 
//------------------------------------------------------------------------------
//
//	Blietooth client API
//
#if ! defined (__bt_api_H__)
#define __bt_api_H__		1

#include <ws2bth.h>
#include <winioctl.h>

#if defined (__cplusplus)
extern "C" {
#endif

//
//		COD classes
//
#define BTH_COD_MAJOR_SERVICE_CLASS_INFORMATION		0x800000
#define BTH_COD_MAJOR_SERVICE_CLASS_TELEPHONY		0x400000
#define BTH_COD_MAJOR_SERVICE_CLASS_AUDIO			0x200000
#define BTH_COD_MAJOR_SERVICE_CLASS_OBEX			0x100000
#define BTH_COD_MAJOR_SERVICE_CLASS_CAPTURE			0x080000
#define BTH_COD_MAJOR_SERVICE_CLASS_RENDERING		0x040000
#define BTH_COD_MAJOR_SERVICE_CLASS_NETWORK			0x020000
#define BTH_COD_MAJOR_SERVICE_CLASS_LIMITED_DISC	0x002000

#define BTH_COD_MAJOR_DEVICE_CLASS_MISC				0x000000
#define BTH_COD_MAJOR_DEVICE_CLASS_COMPUTER			0x000100
#define BTH_COD_MAJOR_DEVICE_CLASS_PHONE			0x000200
#define BTH_COD_MAJOR_DEVICE_CLASS_LAP				0x000300
#define BTH_COD_MAJOR_DEVICE_CLASS_AUDIO			0x000400
#define BTH_COD_MAJOR_DEVICE_CLASS_PERIPHERAL		0x000500
#define BTH_COD_MAJOR_DEVICE_CLASS_UNCLASSIFIED		0x001f00

#define BTH_COD_MINOR_COMPUTER_UNCLASSIFIED			0x000000
#define BTH_COD_MINOR_COMPUTER_DESKTOP				0x000004
#define BTH_COD_MINOR_COMPUTER_SERVER				0x000008
#define BTH_COD_MINOR_COMPUTER_LAPTOP				0x00000c
#define BTH_COD_MINOR_COMPUTER_HANDHELD				0x000010
#define BTH_COD_MINOR_COMPUTER_PDA					0x000014

#define BTH_COD_MINOR_PHONE_UNCLASSIFIED			0x000000
#define BTH_COD_MINOR_PHONE_CELL					0x000004
#define BTH_COD_MINOR_PHONE_CORDLESS				0x000008
#define BTH_COD_MINOR_PHONE_SMART					0x00000c
#define BTH_COD_MINOR_PHONE_WIRED					0x000010

#define BTH_COD_MINOR_LAP_AVAILABLE					0x000000
#define BTH_COD_MINOR_LAP_1_17						0x000004
#define BTH_COD_MINOR_LAP_17_33						0x000008
#define BTH_COD_MINOR_LAP_33_50						0x00000c
#define BTH_COD_MINOR_LAP_50_67						0x000010
#define BTH_COD_MINOR_LAP_67_83						0x000014
#define BTH_COD_MINOR_LAP_83_99						0x000018
#define BTH_COD_MINOR_LAP_NO_SERVICE				0x00001c

#define BTH_COD_MINOR_AUDIO_UNCLASSIFIED			0x000000
#define BTH_COD_MINOR_AUDIO_HEADSET					0x000004

#define BTH_NAMEDEVENT_PAIRING_CHANGED              L"system/events/bluetooth/PairingChange"
#define BTH_NAMEDEVENT_HARDWARE_CHANGED             L"system/events/bluetooth/HardwareChange"
#define BTH_NAMEDEVENT_DEVICEID_CHANGED             L"system/events/bluetooth/DeviceIdChange"
#define BTH_NAMEDEVENT_CONNECTIVITY_CHANGED         L"system/events/bluetooth/ConnectivityChange"
#define BTH_NAMEDEVENT_SECURITY_CHANGED             L"system/events/bluetooth/SecurityChange"
#define BTH_NAMEDEVENT_CONNECTIONS_CHANGED          L"system/events/bluetooth/ConnectionsChange"
#define BTH_NAMEDEVENT_BASEBAND_CHANGED             L"system/events/bluetooth/BasebandChange"
#define BTH_NAMEDEVENT_STACK_INITED                 L"system/events/bluetooth/StackInitialized"

#if ! defined (__bt_ddi_H__)
//
//  Attention: also defined in bt_ddi.h! Keep in sync!
//
//	Hardware Status
//
#define HCI_HARDWARE_UNKNOWN							0
#define HCI_HARDWARE_NOT_PRESENT						1
#define HCI_HARDWARE_INITIALIZING						2
#define HCI_HARDWARE_RUNNING							3
#define HCI_HARDWARE_SHUTDOWN							4
#define HCI_HARDWARE_ERROR								5
#endif

typedef struct _BASEBAND_CONNECTION
{
	USHORT		hConnection;
	BT_ADDR 	baAddress;
	int 		cDataPacketsPending;
	UINT		fLinkType		: 1;
	UINT		fEncrypted		: 1;
	UINT		fAuthenticated	: 1;
	UINT		fMode			: 3;
} BASEBAND_CONNECTION, *PBASEBAND_CONNECTION;

//
//	Management APIs
//
int BthWriteScanEnableMask
(
unsigned char	mask
);

int BthReadScanEnableMask
(
unsigned char	*pmask
);

int BthWritePageTimeout
(
unsigned short timeout
);

int BthReadPageTimeout
(
unsigned short *ptimeout
);

int BthWriteCOD
(
unsigned int	cod
);

int BthReadCOD
(
unsigned int	*pcod
);

int BthWriteAuthenticationEnable
(
unsigned char	ae
);

int BthReadAuthenticationEnable
(
unsigned char	*pae
);

int BthWriteLinkPolicySettings
(
BT_ADDR			*pba,
unsigned short	lps
);

int BthReadLinkPolicySettings
(
BT_ADDR			*pba,
unsigned short	*plps
);

int BthEnterHoldMode
(
BT_ADDR			*pba,
unsigned short	hold_mode_max,
unsigned short	hold_mode_min,
unsigned short  *pinterval
);

int BthEnterSniffMode
(
BT_ADDR			*pba,
unsigned short	sniff_mode_max,
unsigned short	sniff_mode_min,
unsigned short	sniff_attempt,
unsigned short	sniff_timeout,
unsigned short  *pinterval
);

int BthExitSniffMode
(
BT_ADDR			*pba
);

int BthEnterParkMode
(
BT_ADDR			*pba,
unsigned short  beacon_max,
unsigned short  beacon_min,
unsigned short  *pinterval
);

int BthExitParkMode
(
BT_ADDR			*pba
);

int BthGetCurrentMode
(
BT_ADDR			*pba,
unsigned char	*pmode
);

int BthGetBasebandHandles
(
int				cHandles,
unsigned short	*pHandles,
int				*pcHandlesReturned
);

int BthGetBasebandConnections
(
int					cConnections,
BASEBAND_CONNECTION	*pConnections,
int					*pcConnectionsReturned
);

int BthGetAddress
(
unsigned short	handle,
BT_ADDR			*pba
);

int BthReadLocalAddr
(
BT_ADDR         *pba
);

int BthGetHardwareStatus
(
int				*pistatus
);

int BthReadLocalVersion
(
unsigned char	*phci_version,
unsigned short	*phci_revision,
unsigned char	*plmp_version,
unsigned short	*plmp_subversion,
unsigned short	*pmanufacturer,
unsigned char	*plmp_features
);

int BthReadRemoteVersion
(
BT_ADDR			*pba,
unsigned char	*plmp_version,
unsigned short	*plmp_subversion,
unsigned short	*pmanufacturer,
unsigned char	*plmp_features
);

int BthPerformInquiry
(
unsigned int	 LAP,
unsigned char	 length,
unsigned char	 num_responses,
unsigned int	 cBuffer,
unsigned int	 *pcDiscoveredDevices,
BthInquiryResult *InquiryList
);

int BthCancelInquiry
(
void
);

int BthRemoteNameQuery
(
BT_ADDR			*pba,
unsigned int	cBuffer,
unsigned int	*pcRequired,
WCHAR			*szString
);

int BthTerminateIdleConnections
(
void
);

int BthSetInquiryFilter
(
BT_ADDR			*pba
);

int BthClearInquiryFilter
(
void
);

//
//	Security manager APIs
//
int BthSetPIN
(
BT_ADDR			*pba,
int				cPinLength,
unsigned char	*ppin
);

int BthRevokePIN
(
BT_ADDR			*pba
);

int BthSetLinkKey
(
BT_ADDR			*pba,
unsigned char   key[16]
);

int BthGetLinkKey
(
BT_ADDR			*pba,
unsigned char   key[16]
);

int BthRevokeLinkKey
(
BT_ADDR			*pba
);

int BthAuthenticate
(
BT_ADDR			*pba
);

int BthSetEncryption
(
BT_ADDR			*pba,
int				fOn
);

int BthSetSecurityUI
(
HANDLE		hEvent,
DWORD		dwStoreTimeout,
DWORD		dwProcTimeout
);

int BthGetPINRequest
(
BT_ADDR *pbt
);

int BthRefusePINRequest
(
BT_ADDR	*pbt
);

//
//  Connection APIs
//

int BthCreateACLConnection
(
BT_ADDR			*pbt,
unsigned short	*phandle
);

int BthCreateSCOConnection
(
BT_ADDR			*pbt,
unsigned short	*phandle
);

int BthCloseConnection
(
unsigned short	handle
);


//
//	SDP Name Service APIs
//
typedef struct _SdpAttributeRange SdpAttributeRange;
typedef struct _SdpQueryUuid      SdpQueryUuid;
typedef struct _WSAQuerySetW *LPWSAQUERYSET;
typedef enum _WSAESETSERVICEOP WSAESETSERVICEOP;


int BthNsSetService(LPWSAQUERYSET pSet, WSAESETSERVICEOP op, DWORD dwFlags);
int BthNsLookupServiceBegin(LPWSAQUERYSET pQuerySet, DWORD dwFlags, LPHANDLE lphLookup);
int BthNsLookupServiceNext(HANDLE hLookup, DWORD dwFlags, LPDWORD lpdwBufferLength, LPWSAQUERYSET pResults);
int BthNsLookupServiceEnd(HANDLE hLookup);

//
//	RFCOMM Apis
//
#define RFCOMM_PORT_FLAGS_REMOTE_DCB    0x00000001
#define RFCOMM_PORT_FLAGS_KEEP_DCD      0x00000002
#define RFCOMM_PORT_FLAGS_AUTHENTICATE	0x00000004
#define RFCOMM_PORT_FLAGS_ENCRYPT       0x00000008

typedef struct _portemu_port_params {
	int				channel;
	int				flocal;
	BT_ADDR			device;
	int				imtu;
	int				iminmtu;
	int				imaxmtu;
	int				isendquota;
	int				irecvquota;
	GUID			uuidService;
	unsigned int	uiportflags;
} PORTEMUPortParams;

//	Bluetooth serial IOCTLs are cross-defined in pegdser.h to reserve spot there.
#define IOCTL_BLUETOOTH_GET_RFCOMM_CHANNEL	CTL_CODE(FILE_DEVICE_SERIAL_PORT,24,METHOD_BUFFERED,FILE_ANY_ACCESS)
#define IOCTL_BLUETOOTH_GET_PEER_DEVICE 	CTL_CODE(FILE_DEVICE_SERIAL_PORT,25,METHOD_BUFFERED,FILE_ANY_ACCESS)

#if defined (UNDER_CE)
#define rfRegisterDevice RegisterDevice
#define rfDeregisterDevice DeregisterDevice
#define rfCreateFile CreateFile
#define rfReadFile ReadFile
#define rfWriteFile WriteFile
#define rfCloseHandle CloseHandle
#else 
HANDLE rfRegisterDevice
(
LPCWSTR lpszType,
DWORD	dwIndex,
LPCWSTR lpszLib,
DWORD	dwInfo
);

BOOL rfDeregisterDevice
(
HANDLE hDevice
);

HANDLE rfCreateFile
(
LPCTSTR lpFileName,                         // file name
DWORD dwDesiredAccess,                      // access mode
DWORD dwShareMode,                          // share mode
LPSECURITY_ATTRIBUTES lpSecurityAttributes, // SD
DWORD dwCreationDisposition,                // how to create
DWORD dwFlagsAndAttributes,                 // file attributes
HANDLE hTemplateFile                        // handle to template file
);

BOOL rfReadFile(
  HANDLE hFile,                // handle to file
  LPVOID lpBuffer,             // data buffer
  DWORD nNumberOfBytesToRead,  // number of bytes to read
  LPDWORD lpNumberOfBytesRead, // number of bytes read
  LPOVERLAPPED lpOverlapped    // overlapped buffer
  );

BOOL rfWriteFile(
  HANDLE hFile,                    // handle to file
  LPCVOID lpBuffer,                // data buffer
  DWORD nNumberOfBytesToWrite,     // number of bytes to write
  LPDWORD lpNumberOfBytesWritten,  // number of bytes written
  LPOVERLAPPED lpOverlapped        // overlapped buffer
  );

BOOL rfCloseHandle (HANDLE hFile);
#endif

#if defined (__cplusplus)
};			// __cplusplus
#endif

#endif		/* __bt_api_H__ */