qwf_Init()

Updated: April 19, 2023

Initialize all QWF services and create the service context

Synopsis:

#include <qwf/qwf_interface.h>
qwf_ReturnStatus_e qwf_Init(qwf_Context_t **ppCtx)

Arguments:

ppCtx
A pointer to memory for storing a pointer to the new QWF service context

Library:

qwf_interface

Description:

This function initializes all QWF services, creates the QWF service context, and fills in a qwf_Context_t structure with the context's data. The function must return successfully before any service information can be read through the QWF API, because the context pointer provided by this function must be passed into all subsequent API calls.

If you're not using all services, you can initialize individual services by using qwf_InitializeCore() and qwf_InitializeServices() instead.

Returns:

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