RIL_DevSpecific

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/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
);

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.

Return Value

Positive HRESULT values indicate success of the function call and are used as command identifications for matching the asynchronous call result. Zero is not a valid command identification. Negative HRESULT values indicate an error. Errors are defined in the winerror.h file and Ril.h file.

An asynchronous result callback of RIL_RESULT_OK indicates success. The lpData notification parameter points to a byte array containing the asynchronous result produced by the device specific call. For more information on the result callback, see RILRESULTCALLBACK.

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_Initialize
RIL Functions