IAMExtTransport::put_MediaState
| Microsoft DirectShow 9.0 |
IAMExtTransport::put_MediaState
The put_MediaState method sets the current state of the media.
Syntax
HRESULT put_MediaState( long State );
Parameters
State
[in] Specifies the media state as a long integer. Use one of the following:
| Value | Description |
| ED_MEDIA_SPIN_DOWN | For disk media: Stop spinning. For tape media: Unthread the tape. |
| ED_MEDIA_SPIN_UP | For disk media: Start spinning. For tape media: Thread the tape. |
| ED_MEDIA_UNLOAD | Eject the media from the drive. |
These constants are for disk and tape media. Other devices might need to define new constants.
Return Values
When this method succeeds, it returns S_OK. Otherwise it returns an HRESULT error code.
DV Implementation
MSDV does not support this method. It returns E_NOTIMPL.
Requirements
Header: Declared in Strmif.h; include Dshow.h.
Library: Use Strmiids.lib.
See Also