RIL_SetEquipmentState (Windows Embedded CE 6.0)

1/6/2010

This function sets the radio equipment state.

Syntax

HRESULT RIL_SetEquipmentState(
  HRIL hRil,
  DWORD dwEquipmentState
);

Parameters

• hRil
  Handle to the RIL instance returned by RIL_Initialize.

• dwEquipmentState
  Specifies the equipment state to set. For values, see Equipment State Constants.

Return Value

Positive HRESULT values indicate success and are used as command identifications for matching the asynchronous call result. Negative HRESULT values indicate an error. Errors are defined in the Ril.h file.

An asynchronous result of RIL_RESULT_OK indicates success. The lpData notification parameter is set to NULL.

Remarks

This function is to be implemented by a RIL driver. It is called to turn the radio on or off, to enter or exit airplane mode.

The RIL proxy translates the RIL_SetEquipmentState function into IOCTL_RIL_SetEquipmentState when the RIL proxy calls RIL_IOControl.

Requirements

See Also

Reference

RIL Functions
RIL_Initialize
Equipment State Constants