CeRapiInvoke oriented definitions.

Defines
#define	MS_TIMEOUT   10000
	Timeout in millisecond to wait for the RIL callback routine to become ready.
#define	S_PARAM   601
	ID of the error resource string on wrong parameters.
#define	S_ABANDON   602
	ID of the error resource string if wating has been abandoned.
#define	S_TIMEOUT   603
	ID of the timeout error resource string.
#define	S_INIT   604
	ID of the initialization error resource string.
#define	S_QUERY   605
	ID of the error resource string on cell tower info query error.
#define	S_CRTEVNT   606
	ID of the event creation error resource string.
#define	S_UNKNOWN   607
	ID of the resource string for an unknown error.
#define	MAINICON   101
	ID of the icon used in the dll.
Typedefs
typedef struct _IRAPIStream	IRAPIStream
	Stream type for CeRapiInvoke-like functions.
Functions
BOOL WINAPI	DllMain (HANDLE hInstDLL, DWORD dwReason, LPVOID lpvReserved)
	Main entry point for the dll.
HRESULT APIENTRY	getRILCellInfo (DWORD cbInput, BYTE *pInput, DWORD *pcbOutput, BYTE **ppOutput, IRAPIStream *pStream)
	Returns the information about the presenlty active GSM cell.

---

Define Documentation

#define MAINICON   101

ID of the icon used in the dll.

#define MS_TIMEOUT   10000

Timeout in millisecond to wait for the RIL callback routine to become ready.

#define S_ABANDON   602

ID of the error resource string if wating has been abandoned.

#define S_CRTEVNT   606

ID of the event creation error resource string.

#define S_INIT   604

ID of the initialization error resource string.

#define S_PARAM   601

ID of the error resource string on wrong parameters.

#define S_QUERY   605

ID of the error resource string on cell tower info query error.

#define S_TIMEOUT   603

ID of the timeout error resource string.

#define S_UNKNOWN   607

ID of the resource string for an unknown error.

---

Typedef Documentation

typedef struct _IRAPIStream IRAPIStream

Stream type for CeRapiInvoke-like functions.

---

Function Documentation

BOOL WINAPI DllMain	(	HANDLE	hInstDLL,
		DWORD	dwReason,
		LPVOID	lpvReserved
	)

Main entry point for the dll.

Presently the function does nothing.

Parameters:

	hInstDLL	handle to this DLL.
	dwReason	only DLL_PROCESS_ATTACH and DLL_PROCESS_DETACH recognized.
	lpvReserved	ignored.

Returns:

always true.

HRESULT APIENTRY getRILCellInfo	(	DWORD	cbInput,
		BYTE *	pInput,
		DWORD *	pcbOutput,
		BYTE **	ppOutput,
		IRAPIStream *	pStream
	)

Returns the information about the presenlty active GSM cell.

The function is intented to be run from a Host using CeRapiInvoke().

Parameters:

	cbInput	number of bytes in the array pointed by pInput. Presently not used and ignored.
	pInput	array of bytes of the input parameters. Presently not used and ignored.
	pcbOutput	returned number of bytes in the array returned in ppOutput. In fact it is strlen of the string pointed by the pointer returned in ppOutput.
	ppOutput	this returned byte array contains the GSM cell information retrieved from the RIL API. Format: ASCII (not UNICODE!) character string with the following integer values separaated with whitespaces: cbSize, RILCELLTOWERINFO structure size in bytes, dwParams, OR-ed RIL_PARAM constants, see http://msdn.microsoft.com/en-us/library/aa919918.aspx, dwMobileCountryCode, country/region ID, dwMobileNetworkCode, mobile network ID, dwLocationAreaCode, mobile network area ID, dwCellID, cellular tower ID, dwBaseStationID, ID of the base station, dwBroadcastControlChannel, broadcast control channel (BCCH), dwRxLevel, received signal level, dwRxLevelFull, received signal level in the full network, dwRxLevelSub, received signal level in the subsystem, dwRxQuality, received signal quality, dwRxQualityFull, received signal quality in the full network, dwRxQualitySub, received signal quality in the subsystem, dwIdleTimeSlot, idle timeslot, dwTimingAdvance, timing advance, dwGPRSCellID, ID of the GPRS cellular tower, dwGPRSBaseStationID, ID of the GPRS base station, dwNumBCCH, number of the BCCH.
	pStream	stream mode not supported yet and this parameter is not used and ignored.

Returns:

S_OK or error code.