| Microsoft DirectX 9.0 |
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
Returns an HRESULT. Possible errors include the following.
| Value | Description |
| HRESULT_FROM_WIN32(ERROR_REQ_NOT_ACCEP) | The device did not accept the command. |
| S_OK | Success. |
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