IAMExtTransport::put_Mode method (strmif.h)
[The feature associated with this page, DirectShow, is a legacy feature. It has been superseded by MediaPlayer, IMFMediaEngine, and Audio/Video Capture in Media Foundation. Those features have been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer, IMFMediaEngine and Audio/Video Capture in Media Foundation instead of DirectShow, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]
The put_Mode method sets the transport mode; for example, play, stop, or record.
Syntax
HRESULT put_Mode(
[in] long Mode
);
Parameters
[in] Mode
Specifies the transport mode. 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 value
Returns an HRESULT. Possible errors include the following.
| Return code | Description |
|---|---|
|
The device did not accept the command. |
|
Success. |
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 2000 Professional [desktop apps only] |
| Minimum supported server | Windows 2000 Server [desktop apps only] |
| Target Platform | Windows |
| Header | strmif.h (include Dshow.h) |
| Library | Strmiids.lib |