IAMExtTransport::GetCapability 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.]
GetCapability method retrieves the general capabilities of the transport.
[in] long Capability,
[out] long *pValue,
[out] double *pdblValue
Specifies the capability to check. See Remarks for more information.
Pointer to a variable that receives a long integer. See Remarks for more information.
Pointer to a variable that receives a double. See Remarks for more information.
When this method succeeds, it returns S_OK. Otherwise it returns an HRESULT error code.
The Capability parameter is a flag that specifies which capability to check. The method returns the result either in the pValue parameter or in the pdblValue parameter, depending on the capability flag.
For the following flags, the method returns the value OATRUE or OAFALSE in the pValue parameter. The value OATRUE indicates that the capability is present, while the value OAFALSE indicates it is absent.
|Transport can use assemble record mode (record new tracks that link seamlessly to the control track from the previously recorded segment).
|Transport can synchronize by varying speed.
|Transport can perform delayed-in audio edits.
|Transport can perform delayed-out audio edits.
|Transport can perform delayed-in video edits.
|Transport can perform delayed-out video edits.
|Transport can detect the length of the media.
|Transport can eject the media.
|Transport can freeze/pause.
|Transport can use insert record mode (record individual tracks while locked to a prerecorded control track).
|Transport can play backward.
|Transport can show the device's input on its output.
|Transport can show media playback on its output.
|Transport responds to a frame advance command by advancing one field.
|Device has a clock.
|Device has dynamic tracking.
|Device has a timer.
|Device has a tuner.
|Device is the master clock for synchronizing.
|Device supports multiple edit events.
|Device must be cued before it performs an edit.
|Device needs to be calibrated.
For the following flags, the method returns a numeric value in the pValue parameter.
|Returns the track number of the LTC timecode track, or ED_ALL if there is no dedicated timecode track.
|Returns the number of audio tracks.
For the following flags, the method returns a value in the pdblValue parameter.
|Maximum forward speed in shuttle mode, as a multiple of play speed.
|Minimum forward speed in shuttle mode, as a multiple of play speed.
|Maximum forward speed, as a multiple of play speed.
|Minimum forward speed, as a multiple of play speed.
|Maximum reverse speed in shuttle mode, as a multiple of play speed.
|Minimum reverse speed in shuttle mode, as a multiple of play speed.
|Maximum reverse speed, as a multiple of play speed.
|Minimum reverse speed, as a multiple of play speed.
MSDV does not support this method. It returns E_NOTIMPL.
|Minimum supported client
|Windows 2000 Professional [desktop apps only]
|Minimum supported server
|Windows 2000 Server [desktop apps only]
|strmif.h (include Dshow.h)