RIL_WriteMsg (Compact 2013)

3/26/2014

This function writes a message to the current storage location.

Syntax

HRESULT RIL_WriteMsg(
  HRIL hRil,
  const RILMESSAGE* lpMessage,
  DWORD dwStatus
);

Parameters

• hRil
  Handle to the RIL instance returned by RIL_Initialize.

• lpMessage
  Message to be written. The message must be of type RIL_MSGTYPE_IN_DELIVER or RIL_MSGTYPE_OUT_SUBMIT.

• dwStatus
  Specifies the status to be assigned to the written message. For values, see Message Status 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 points to a DWORD containing the index used.

Remarks

The RIL proxy translates the RIL_WriteMsg function into IOCTL_RIL_WriteMsg when the RIL proxy calls RIL_IOControl.

RIL_NOTIFY_MSGSTORED is required for success indication.

RIL_NOTIFY_MSGSTORED shall be returned when a message stored. The lpData notification parameter points to the index occupied by the stored message."

Requirements

See Also

Reference

RIL Functions
RIL_Initialize
Message Status Constants