1.1.9.5 WDRV_WINC_BSSFIND_NOTIFY_CALLBACK Typedef

C

typedef bool (*WDRV_WINC_BSSFIND_NOTIFY_CALLBACK)
(
    DRV_HANDLE handle,
    uint8_t index,
    uint8_t ofTotal,
    WDRV_WINC_BSS_INFO *pBSSInfo
);

Description

When the information about a discovered BSS is requested the driver will use this callback to provide the BSS information to the user.

Parameters

ParametersDescription
handleClient handle obtained by a call to WDRV_WINC_Open.
indexIndex of BSS find results.
ofTotalTotal number of BSS find results.
pBSSInfoPointer to BSS information structure.

Returns

  • true - If true is returned the WINCS02 driver will automatically fetch the next BSS find results which will cause a later call to this callback.

  • false - If false is returned the WINCS02 driver will not fetch the next BSS find results, the user must call WDRV_WINC_BSSFindNext to retrieve them.

Remarks

The callback function must return true or false. true indicates that the user wishes the next BSS information structure be provided. false indicates that the user will call WDRV_WINC_BSSFindNext to obtain the next BBS information structure.