# WM_EnableForListening

## Syntax

      #include <nitro/wm.h>

      WMErrCode WM_EnableForListening( WMCallbackFunc callback, BOOL blink );

## Arguments

callback | Designates the callback function to call when the asynchronous process completes. This callback is called from within the interrupt handler.
blink | Specifies TRUE if the power LED is flashing at variable speed.

## Return Values

Returns the results of the `WMErrCode` enumerated type process.

## Description

Puts the wireless hardware enabled in receive-only mode. If this function's return value is `WM_ERRCODE_OPERATING`, a callback will be called after the wireless hardware enable process completes. This function can only be called when the WM is in the `READY` state. After completion, the WM will move to the `STOP` state. To start communications after this function is called, you must use `WM_PowerOn` to start providing power to the wireless hardware.

Unlike WM_Enable, operations that require transmitting wireless signals will not be available if this function is used for initialization. In exchange, it is possible to make the power LED stop flashing. Scanning in passive mode and measuring channel availability are examples of operations that do not require transmitting wireless signals.

## See Also

`WM_Enable, WM_Init, WM_PowerOn, WM_PowerOff, WM_Disable, WM_Finish, WM_InitializeForListening, WM_End`

## Revision History

2007/11/12 Initial version.

CONFIDENTIAL