IPixCaptureFileConverter::UpgradeGpuCaptureFile method

Upgrades a GPU capture file from an older on-disk format to the current format. If the source is already in the current format this is a no-op that returns S_OK without writing the destination.

Syntax

HRESULT UpgradeGpuCaptureFile(
    LPCWSTR sourceFilePath,
    LPCWSTR destinationFilePath,
    IPixProgressNotifications * progress);

Parameters

sourceFilePath [in]

Local path of the capture file to upgrade. Required.

destinationFilePath [in]

Local path that should receive the upgraded capture. Required. May be the same as sourceFilePath; the upgrade is staged through a temporary file so an in-place upgrade does not corrupt the source on failure. Parent directories are created if missing.

progress [in]

Optional progress sink (may be null). OnProgress is invoked from a worker thread; implementations must be thread-safe.

Returns

S_OK on success or no-op, E_PIX_INVALID_FILE if the source is missing or not a recognized GPU capture, or an HRESULT from the underlying conversion on failure.

See also