KSPROPERTY_STREAM_MASTERCLOCK

The KSPROPERTY_STREAM_MASTERCLOCK property is an optional property that should be implemented if the pin uses or produces a master clock that can be used for synchronization.

Usage Summary Table

Get	Set	Target	Property Descriptor Type	Property Value Type
Yes	Yes	Pin	KSPROPERTY	HANDLE

Remarks

The property returns a NULL handle when queried. Support is determined by whether the call returns successfully.

You can use KSPROPERTY_STREAM_MASTERCLOCK to query whether a master clock is supported by a pin or to set the current master clock for a pin. This is typically done through a graph manager, such as in DirectShow. A master clock handle is retrieved and can be used to set the master clock on another pin, or can be used as the user-mode proxy of a master clock, such as in a DirectShow graph.

When the clock is set on a pin, the pin references the underlying file object and can later perform queries against that file object. The file handle itself must be closed by the client that queried for the handle.

A filter does not need to support the property when it neither produces a master clock nor needs to reference one, such as a converter filter placed in the middle of a graph with no need to synchronize with other streams. The property can also be used as read-only when a filter produces a master clock but does not synchronize to an external master clock.

Also see KS Clocks and AVStream Clocks.

Requirements

Header

Ks.h (include Ks.h)

See also

KSPROPERTY