Edit

KSPROPERTY_STREAM_FRAMETIME

  • Article

The KSPROPERTY_STREAM_FRAMETIME property allows a client to determine the duration of the next frame based on the particular media stream, and use that information to step-frame a sequence.

Usage Summary Table

Get Set Target Property Descriptor Type Property Value Type

Yes

No

Pin

KSPROPERTY

KSFRAMETIME

Remarks

KSPROPERTY_STREAM_FRAMETIME is an optional property that should be implemented if a pin recognizes the specifics of the media type it is transporting.

The property is supported by rendering pins and is used to return the duration of the next frame of data and any flags associated with that frame. A frame is generally the smallest usable unit into which the data can be split. For a video stream, this might be a video frame or a field. For audio, this would be a sample for each channel in the stream. For MIDI, this would be the next MIDI event.

The duration is measured in terms of the presentation time units provided by the pin. This is dependent on the interface and the numerator/denominator pair used in the presentation time. This does not apply to streams that are not oriented toward any specific media type, such as generic file readers.

Requirements

Header

 Ks.h (include Ks.h)

See also

KSPROPERTY

KSFRAMETIME