1.3.3.5 WDRV_PIC32MZW_BSSFindFirst Function

C

WDRV_PIC32MZW_STATUS WDRV_PIC32MZW_BSSFindFirst
(
DRV_HANDLE handle,
WDRV_PIC32MZW_CHANNEL_ID channel,
bool active,
const WDRV_PIC32MZW_SSID_LIST *const pSSIDList,
const WDRV_PIC32MZW_BSSFIND_NOTIFY_CALLBACK pfNotifyCallback
)

Summary

Request a BSS scan is performed by the PIC32MZW.

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_PIC32MZW_Initialize must have been called. WDRV_PIC32MZW_Open must have been called to obtain a valid handle.

Parameters

ParamDescription
handleClient handle obtained by a call to WDRV_PIC32MZW_Open.
channelChannel to scan, maybe WDRV_PIC32MZW_CID_ANY in which case all enabled channels are scanned.
activeUse active vs passive scanning.
pSSIDListPointer to list of SSIDs to match on.
pfNotifyCallbackCallback to receive notification of first BSS found.

Returns

WDRV_PIC32MZW_STATUS_OK - A scan was initiated.

WDRV_PIC32MZW_STATUS_NOT_OPEN - The driver instance is not open.

WDRV_PIC32MZW_STATUS_REQUEST_ERROR - The request to the PIC32MZW was rejected.

WDRV_PIC32MZW_STATUS_INVALID_ARG - The parameters were incorrect.

WDRV_PIC32MZW_STATUS_SCAN_IN_PROGRESS - A scan is already in progress.

Remarks

If channel is WDRV_PIC32MZW_CID_ANY then all enabled channels are scanned. The enabled channels can be configured using WDRV_PIC32MZW_BSSFindSetEnabledChannels. How the scan is performed can be configured using WDRV_PIC32MZW_BSSFindSetScanParameters.