Method
FwupdPluginDeviceread_firmware
since: 2.0.11
Declaration [src]
FuFirmware*
fu_device_read_firmware (
  FuDevice* self,
  FuProgress* progress,
  FuFirmwareParseFlags flags,
  GError** error
)
Description [src]
Reads firmware from the device by calling a plugin-specific vfunc. The device subclass should try to ensure the firmware does not contain any serial numbers or user-configuration values and can be used to calculate the device checksum.
The return value can be converted to a blob of memory using fu_firmware_write().
Available since: 2.0.11
Parameters
- progress
- 
            Type: FuProgressA FuProgress.The data is owned by the caller of the method. 
- flags
- 
            Type: FuFirmwareParseFlagsFuFirmwareParseFlags, e.g.FU_FIRMWARE_PARSE_FLAG_NONE.
- error
- 
            Type: GError **The return location for a recoverable error. The argument can be NULL.If the return location is not NULL, then you must initialize it to aNULLGError*.The argument will be left initialized to NULLby the method if there are no errors.In case of error, the argument will be set to a newly allocated GError; the caller will take ownership of the data, and be responsible for freeing it.
Return value
Type: FuFirmware
A FuFirmware, or NULL for error.
| The caller of the method takes ownership of the returned data, and is responsible for freeing it. |