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:
  1. cbSize, RILCELLTOWERINFO structure size in bytes,
  2. dwParams, OR-ed RIL_PARAM constants, see http://msdn.microsoft.com/en-us/library/aa919918.aspx,
  3. dwMobileCountryCode, country/region ID,
  4. dwMobileNetworkCode, mobile network ID,
  5. dwLocationAreaCode, mobile network area ID,
  6. dwCellID, cellular tower ID,
  7. dwBaseStationID, ID of the base station,
  8. dwBroadcastControlChannel, broadcast control channel (BCCH),
  9. dwRxLevel, received signal level,
  10. dwRxLevelFull, received signal level in the full network,
  11. dwRxLevelSub, received signal level in the subsystem,
  12. dwRxQuality, received signal quality,
  13. dwRxQualityFull, received signal quality in the full network,
  14. dwRxQualitySub, received signal quality in the subsystem,
  15. dwIdleTimeSlot, idle timeslot,
  16. dwTimingAdvance, timing advance,
  17. dwGPRSCellID, ID of the GPRS cellular tower,
  18. dwGPRSBaseStationID, ID of the GPRS base station,
  19. 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.


Generated on Mon Jul 12 14:51:51 2010 for cetoys by  doxygen 1.5.6