Microsoft DirectX 8.1 (C++)

IAMExtTransport::put_Mode

The put_Mode method sets the transport mode; for example, play, stop, or record.

Syntax

HRESULT put_Mode(
  long Mode
);

Parameters

Mode

[in]  Specifies the transport mode as a long integer. Use one of the following values.

Value Description
ED_MODE_PLAY Play.
ED_MODE_STOP Stop.
ED_MODE_FREEZE Pause.
ED_MODE_THAW Resume.
ED_MODE_FF Fast forward.
ED_MODE_REW Rewind.
ED_MODE_RECORD Record.
ED_MODE_RECORD_FREEZE Pause recording.
ED_MODE_RECORD_STROBE Record single frame.
ED_MODE_STEP_FWD Single step forward.
ED_MODE_STEP_REV Single step backward.
ED_MODE_SHUTTLE Shuttle (high-speed movement with visible picture). Use with IAMExtTransport::put_Rate to set the transport speed.
ED_MODE_EDIT_CUE Position transport to the cue point for an active edit event.
ED_MODE_LINK_ON Link this method to the graph's IMediaControl::Run, IMediaControl::Stop, and IMediaControl::Pause methods.
ED_MODE_LINK_OFF Disengage this method from the graph's IMediaControl methods.

Return Values

When this method succeeds, it returns S_OK. Otherwise it returns an HRESULT error code.

DV Implementation

Of the constants listed previously, MSDV supports the following:

MSDV supports some additional modes that are defined in the header file Xprtdefs.h.

Value Description
ED_MODE_PLAY_FASTEST_FWD Fastest forward.
ED_MODE_PLAY_SLOWEST_FWD Slowest forward.
ED_MODE_PLAY_FASTEST_REV Fastest reverse.
ED_MODE_PLAY_SLOWEST_REV Slowest reverse.

See Also