Chapter 2 — Using the Filter Manager API
25
Basic Filter Manager Methods
segments of a programmed pause/resume encode). This number is calculated
during the
Cue()
process. It can be used in combination with the CurrentFrame-
Count property to determine how much of the encode has been completed.
CurrentFrameCount(long):
(Get)
While an encode is in progress, this property
indicates the number of frames that have already been encoded by the primary
encoding process. It has no meaning if an encode is not currently running. If
this property is used to update a progress bar, it should be called in its own
separate thread.
Transcode:
(Put)
The transcoding feature is not yet supported, so this property
should be set to FALSE.
Basic Filter Manager Methods
In addition to methods designed to load and save encode parameters, the Filter
Manager interface offers eight basic methods that control the operation of the
encoder. Each of these methods sets the value of
result
to report its success or
failure in carrying out the requested task. Generally speaking, if
result
is 0 or
positive when the method returns, then the method ended successfully. Negative
values represent failure. The allowable state transitions for the Argus encoder
are depicted in the following table:
Allowable State Transitions
Current State
Allowed Commands
Resulting State
Success
Failure
Start State
Initialize()
Initialized
Exit
Exit
Initialized
Reset()
Reset state
Exit
Exit
Reset State
Cue()
Cued
Initialized
Cued
Start()
Started
Initialized
Started
Pause()
Paused
Initialized
End() or Stop()
Initialized
Initialized
Table 2-2. Argus Allowable State Transitions
