RIL_DevSpecific (Windows Embedded CE 6.0)

1/6/2010

This function is used by OEMs to provide custom calls into the RIL driver. It is an extension mechanism allowing the RIL driver developer to include any needed additional functionality.

Syntax

HRESULT RIL_DevSpecific(
  HRIL hRil,
  const BYTE* lpbParams,
  DWORD dwSize,
  BYTE* pbAsyncResults = NULL,
  DWORD dwAsyncResultsSize = RIL_NOTIFYTHREAD_ALLOCSIZE,
  DWORD* pcbAsyncResults = NULL,
  DWORD dwTimeOut = RIL_DEVSPECIFIC_ASYNC_RESPONSE_TIMEOUT
);

Parameters

• hRil
  Handle to the RIL instance returned by RIL_Initialize.

• lpbParams
  Pointer to a buffer containing any parameters required for the device specific call.

• dwSize
  Specifies the size of the data, in bytes, pointed to by lpbParams.

• pbAsyncResults **
  **Pointer to the array returned by the device specific call.

  Applications calling RIL_DevSpecific are responsible for allocating and freeing memory pointed to by pbAsyncResults.**

• dwAsyncResultsSize **
  **Specifies the overall size, in bytes, of the returned array pointed to by pbAsyncResults.

  The size of the array must be at least RIL_NOTIFYTHREAD_ALLOCSIZE (the current default value is 256).

  Memory for the array must be allocated and released by the calling application.**

• pcbAsyncResults **
  Pointer to the actual length of the returned array, in bytes.

• dwTimeOut **
  Time out value, in milliseconds. Specified by the constant RIL_DEVSPECIFIC_ASYNC_RESPONSE_TIMEOUT**.

  It indicates how long the RIL driver/proxy will wait until it returns with a timeout error.**

Return Value

An HRESULT** value of S_OK indicates success. HRESULT values of E_XXX indicate an error. Errors are defined in the winerror.h file.

This function is synchronous. An asynchronous result callback is not called. If the function succeeds, the array pointed to by pbAsyncResult contains the final results.**

Remarks

If the calling application and the driver agree on the interpretation of the lpbParams buffer and the lpData return value, then any additional functionality may be implemented with this mechanism.

The RIL proxy translates the RIL_DevSpecific function into IOCTL_RIL_DevSpecific when the RIL proxy calls RIL_IOControl.

Requirements

See Also

Reference

RIL Functions
RIL_Initialize