KsPinGetReferenceClockInterface function (ks.h)

The KsPinGetReferenceClockInterface function returns a COM style interface to the reference clock associated with Pin. This interface pointer will be an IKsReferenceClock interface.

Syntax

KSDDKAPI NTSTATUS KsPinGetReferenceClockInterface(
  [in]  PKSPIN             Pin,
  [out] PIKSREFERENCECLOCK *Interface
);

Parameters

[in] Pin

A pointer to the KSPIN structure for which to return the reference clock interface.

[out] Interface

A pointer to a memory location that receives the address of an IKsReferenceClock interface. This is a COM style interface with an associated reference count. Minidrivers must release the interface when finished with it.

Return value

KsPinGetReferenceClockInterface returns STATUS_SUCCESS and deposits the address of the IKsReferenceClock interface into Interface if the pin implements the clock or has received notification of the master clock through the KSPROPERTY_STREAM_MASTERCLOCK property. Returns STATUS_DEVICE_NOT_READY if the pin has not yet received notification of the master clock.

Remarks

The most common time to call KsPinGetReferenceClockInterface is in a state transition to KSSTATE_ACQUIRE.

See AVStream Clocks for more information about using the IKsReferenceClock interface that this routine returns.

Requirements

Requirement Value
Minimum supported client Available in Microsoft Windows XP and later operating systems and DirectX 8.0 and later DirectX versions.
Target Platform Universal
Header ks.h (include Ks.h)
Library Ks.lib
IRQL PASSIVE_LEVEL

See also

IKsControl

IKsReferenceClock

KsFilterGetOuterUnknown

KsGetOuterUnknown

KsPinGetConnectedFilterInterface

KsPinGetConnectedPinInterface

KsPinSetPinClockTime

KsRegisterAggregatedClientUnknown