qwf_InitializeServices()

Updated: April 19, 2023

Initialize a subset of the QWF services

Synopsis:

#include <qwf/qwf_interface.h>
qwf_ReturnStatus_e qwf_InitializeServices(qwf_Context_t *pCtx,
                                          qwf_Service_e servicesMask)

Arguments:

pCtx
A pointer to the QWF service context created by qwf_InitializeCore()
servicesMask
A bitfield of flags indicating the services to be initialized

Library:

qwf_interface

Description:

This function initializes a subset of the QWF services. It is intended for use after qwf_InitializeCore() has been called to initialize the QWF core event-handling mechanism. For example, a client program could initialize only Wi-Fi and Networking if it doesn't use cellular connections.

The client can call this function multiple times with different services indicated in servicesMask; for example, once during system startup and then later after a service has been terminated using qwf_CleanupServices().

This function must return successfully before any information for the indicated services can be read through the QWF API.

Returns:

RETURN_STATUS_SUCCESS on success, RETURN_STATUS_FAILURE otherwise. If this function fails, it's due to an unrecoverable error (e.g., a serious memory issue) and the system needs a reboot.