1.1.9.6 WDRV_WINC_BSSFindFirst

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
)

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


Parameters	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_BSSFindSetScanChannels24. How the scan is performed can be configured using WDRV_WINC_BSSFindSetScanParameters.