Partager via


IAMExtTransport Interface

 
Microsoft DirectShow 9.0

IAMExtTransport Interface

The IAMExtTransport interface controls the transport on a video tape recporder (VTR) or camcorder. Applications can use this interface to play, record, or stop the transport; determine whether the transport contains media; and other transport-related functions. The implementation of this interface can vary, depending on the device. Some methods might return E_NOTIMPL if the device does not support them.

This interface also contains methods for non-linear editing through edit events and edit property sets. Currently, DirectShow does not provide any filters or drivers that implement this part of the interface.

Filter Developers: Implement this interface if you are writing a filter that controls an external device with a transport, such as a VTR. If you implement this interface, you should implement the IAMExtDevice interface as well.

Requirements

The DV device drivers require some additional constants that are defined in the header file Xprtdefs.h.

Hardware Requirements

To control an external VCR, certain hardware requirements are recommended. VCRs with an RS-422 serial interface require a special serial port card or an external RS-232-to-RS-422 adapter. In addition, for best performance, your computer should have a serial port card built with a 16550 high-performance UART to sustain higher baud rates, such as 38.4 baud.

In addition to the methods inherited from IUnknown, the IAMExtTransport interface exposes the following methods.

Method Description
GetCapability Retrieves the general capabilities of an external transport.
put_MediaState Sets the current state of the media.
get_MediaState Retrieves the current state of the media.
put_LocalControl Sets the state of the device to local or remote control.
get_LocalControl Retrieves the state of the device.
GetStatus Determines the status of the transport.
GetTransportBasicParameters Retrieves the transport's basic parameter settings.
SetTransportBasicParameters Sets the transport's basic parameters.
GetTransportVideoParameters Retrieves the transport's video parameter settings.
SetTransportVideoParameters Sets the video parameters for the transport.
GetTransportAudioParameters Retrieves the transport's audio parameter settings.
SetTransportAudioParameters Sets audio parameter settings for the transport.
put_Mode Sets the movement of the transport to a new mode, such as play, stop, or record.
get_Mode Retrieves the mode of the transport.
put_Rate Sets the playback rate for variable-speed external devices.
get_Rate Retrieves the playback rate.
GetChase Retrieves the status of chase mode.
SetChase Enables or disables chase mode.
GetBump Retrieves status of bump mode.
SetBump Temporarily changes the speed of playback for synchronization of multiple external devices.
get_AntiClogControl Determines if the anti-headclog control is enabled or disabled.
put_AntiClogControl Enables or disables the transport's anti-headclog control.
GetEditPropertySet Retrieves the current state of an edit property set.
SetEditPropertySet Registers an edit property set that describes a group of edit properties.
GetEditProperty Retrieves individual parameters and values associated with a particular edit property set.
SetEditProperty Defines individual parameters and values associated with a particular edit property set.
get_EditStart Determines whether edit control is active.
put_EditStart Activates edit control.

Remarks

For Windows Driver Model (WDM) devices, the WDM Video Capture Filter automatically exposes this interface if the WDM driver supports the PROPSETID_EXT_TRANSPORT property set. For more information, see the DirectX DDK documenation.

Requirements

Header: Declared in Strmif.h; include Dshow.h.

Library: Use Strmiids.lib.