Partager via

OEMWriteSnapshot (Compact 2013)

  • Article

10/16/2014

This OEM-implemented function writes the snapshot image to nonvolatile storage.

Syntax

BOOL OEMWriteSnapshot(
    LPCVOID pSnapshot,
    DWORD cbSize,
    DWORD dwOfst);

Parameters

  • pSnapshot
    [in] Pointer to the snapshot image to write to storage.
  • cbSize
    [in] Number of bytes of the snapshot image to write to storage.
  • dwOfst
    [in] Offset from the beginning of the data pointed to by pSnapshot where the data to write into snapshot storage begins.

Note

On entry, pSnapshot, cbSize, and dwOfst are all guaranteed to be 4 KB-aligned.

Return Value

Implement this function so that it returns TRUE if the snapshot image is successfully written to storage; otherwise, return FALSE.

Remarks

The OEM must implement this function if the OEM supports snapshot boot.

If you implement this function, provide its address in the pfnSnapWrite member of SnapshotSupport.

The OS calls this function multiple times until all the snapshot data has been written to storage. When all the snapshot data has been written, this function is called one last time with pSnapshot = NULL, cbSize = 0, and dwOfst = 0. On the last call, you can perform cleanup tasks, such as closing the snapshot storage or saving checksums.

Requirements

Header

Developer Implemented

Library

OEMMain.lib or OEMMain_StaticKITL.lib

See Also

Reference

Optional OAL Functions