amfIMarker SetInitialFrameIndex

Sets the index of the initial frame for which the marker will be tracked.

Syntax

marker_handle SetInitialFrameIndex idx

Description

Sets the frame number at which the marker will begin to be tracked during the tracking calculation.

Inputs

idx
The default value of the initial frame index is 0.

Example

marker_handle SetInitialFrameIndex 23

Error

An error will be returned if any of the following cases are true:
  • idx is less than 0.
  • idx is greater than or equal to the frame count of the video
  • idx is greater than the value returned by amfIMarker::GetFinalFrameIndex
Standard hwResult error codes:
  • 1 = HW_Error
  • 3 = HW_InvalidHandle
  • 4 = HW_InvalidArgs