RIL_SetAudioDevices

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This function is implemented by a RIL driver. It is responsible for setting the devices to be used for transmitting and receiving audio from the radio.

Syntax

HRESULT RIL_SetAudioDevices(
  HRIL hRil,
  const RILAUDIODEVICEINFO* lpAudioDeviceInfo
);

Parameters

• hRil
  Handle to the RIL instance returned by RIL_Initialize.

• lpAudioDeviceInfo
  Audio devices to set.

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.

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

Remarks

This function is called during the setup and teardown of voice calls. If multiple audio devices are not supported by the radio, it is acceptable for this function to return RIL_RESULT_OK asynchronously.

The RIL proxy translates the RIL_SetAudioDevices function into IOCTL_RIL_SetAudioDevices when the RIL proxy calls RIL_IOControl.

Requirements

See Also

Reference

RIL_Initialize