1.2.5.2 WDRV_WINC_BSSFindFirst Function

C

WDRV_WINC_STATUS WDRV_WINC_BSSFindFirst
(
DRV_HANDLE handle,
WDRV_WINC_CHANNEL_ID channel,
bool active,
const WDRV_WINC_SSID_LIST *const pSSIDList,
const WDRV_WINC_BSSFIND_NOTIFY_CALLBACK pfNotifyCallback
)

Summary

Request a BSS scan is performed by the WINC.

Description

A scan is requested on the specified channels. An optional callback can be provided to receive notification of the first BSS discovered.

Precondition

WDRV_WINC_Initialize must have been called. WDRV_WINC_Open must have been called to obtain a valid handle.

Parameters


Param	Description
handle	Client handle obtained by a call to WDRV_WINC_Open.
channel	Channel to scan, maybe WDRV_WINC_ALL_CHANNELS or WDRV_WINC_CID_ANY in which case all enabled channels are scanned.
active	Use active vs passive scanning.
pSSIDList	Pointer to list of SSIDs to match on.
pfNotifyCallback	Callback to receive notification of first BSS found.

Returns

WDRV_WINC_STATUS_OK - A scan was initiated.

WDRV_WINC_STATUS_NOT_OPEN - The driver instance is not open.

WDRV_WINC_STATUS_REQUEST_ERROR - The request to the WINC was rejected.

WDRV_WINC_STATUS_INVALID_ARG - The parameters were incorrect.

WDRV_WINC_STATUS_SCAN_IN_PROGRESS - A scan is already in progress.

Remarks

If channel is WDRV_WINC_ALL_CHANNELS or WDRV_WINC_CID_ANY then all enabled channels are scanned. The enabled channels can be configured using WDRV_WINC_BSSFindSetEnabledChannels. How the scan is performed can be configured using WDRV_WINC_BSSFindSetScanParameters.