1.1.14.3 WDRV_WINC_DeviceFirmwareImagePrepare

C

WDRV_WINC_STATUS WDRV_WINC_DeviceFirmwareImagePrepare
(
    DRV_HANDLE handle,
    uint8_t *const pImage,
    size_t imageLength,
    WDRV_WINC_PARTITION partition,
    WDRV_WINC_IMAGE_STATE imageState
)

Description

Modifies the Firmware Image Source Address and Sequence Number fields of a WINC device firmware image.

Precondition

WDRV_WINC_Initialize must have been called.

WDRV_WINC_Open must have been called to obtain a valid handle.

Parameters

ParametersDescription
handleClient handle obtained by a call to WDRV_WINC_Open.
pImagePointer to the image to be modified.
imageLengthLength of the image to be modified.
partitionThe device partition into which the image is to be programmed.
imageStateThe desired state of the image after programming.

Returns

  • WDRV_WINC_STATUS_OK - The image has been modified.
  • WDRV_WINC_STATUS_NOT_OPEN - The driver instance is not open.
  • WDRV_WINC_STATUS_INVALID_ARG - The parameters were incorrect.
  • WDRV_WINC_STATUS_REQUEST_ERROR - A request to the WINC was rejected.
  • WDRV_WINC_STATUS_RETRY_REQUEST - Functionality not available, try again.

Remarks

The only values of imageState parameter supported by this function are WDRV_WINC_IMAGE_STATE_LATENT and WDRV_WINC_IMAGE_STATE_ACTIVATED.