IMbnRadio::SetSoftwareRadioState method (mbnapi.h)

Sets the software radio state of a Mobile Broadband device.

Syntax

HRESULT SetSoftwareRadioState(
  [in]  MBN_RADIO radioState,
  [out] ULONG     *requestID
);

Parameters

[in] radioState

A MBN_RADIO value that specifies the new software radio state.

[out] requestID

A pointer to a request ID assigned by the Mobile Broadband service to identify this request.

Return value

This method can return one of these values.

Remarks

SetSoftwareRadioState changes the software radio state of the device. This is an asynchronous operation and it will return immediately. On completion, the Mobile Broadband service will call the OnSetSoftwareRadioStateComplete method of the IMbnRadioEvents interface.

Disabling the radio for a Mobile Broadband device will result in deactivation of any active connection, network packet detach, and network deregistration. If the radio off operation results in a change in the connection state, packet attach state, or network registration state, then the application will receive a notification of the changes.

When both software and hardware radio are enabled for a Mobile Broadband device, it will automatically try to register to the network. Also, some devices may also try to a perform packet attach to the network. Whenever the state changes, the calling application will receive event notifications for network registration and packet attach state changes.

A device's radio state can change without a change request from the application. For instance, if a user turns on the system's hardware radio switch. The Mobile Broadband service will notify the application about a change in radio state by calling the OnRadioStateChange method of the IMbnRadioEvents interface.

Requirements

See also

IMbnRadio