RIL_GetEquipmentState

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This function retrieves the current equipment state.

Syntax

HRESULT RIL_GetEquipmentState(
  HRIL hRil
);

Parameters

• hRil
  Handle to the RIL instance returned by RIL_Initialize.

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 points to a RILEQUIPMENTSTATE structure.

Remarks

This function can be called by the system to determine both if the radio is on and what features are ready, and in response to a lineGetEquipmentState call.

The RIL proxy translates the RIL_GetEquipmentState function into IOCTL_RIL_GetEquipmentState when the RIL proxy calls RIL_IOControl.

Requirements

See Also

Reference

RIL_Initialize
RILEQUIPMENTSTATE