Skip to content

Latest commit

 

History

History
103 lines (64 loc) · 3.91 KB

nf-ks-kspingetreferenceclockinterface.md

File metadata and controls

103 lines (64 loc) · 3.91 KB
UID title description old-location tech.root ms.date keywords ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames f1_keywords topic_type api_type api_location api_name
NF:ks.KsPinGetReferenceClockInterface
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.
stream\kspingetreferenceclockinterface.htm
stream
04/23/2018
KsPinGetReferenceClockInterface function
KsPinGetReferenceClockInterface, KsPinGetReferenceClockInterface function [Streaming Media Devices], avfunc_7434698b-f441-4d80-91db-8fa5d7d10c60.xml, ks/KsPinGetReferenceClockInterface, stream.kspingetreferenceclockinterface
ks.h
Ks.h
Universal
Available in Microsoft Windows XP and later operating systems and DirectX 8.0 and later DirectX versions.
Ks.lib
PASSIVE_LEVEL
Windows
KsPinGetReferenceClockInterface
ks/KsPinGetReferenceClockInterface
APIRef
kbSyntax
LibDef
Ks.lib
Ks.dll
KsPinGetReferenceClockInterface

KsPinGetReferenceClockInterface function

-description

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

-parameters

-param Pin [in]

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

-param Interface [out]

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.

-returns

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.

-see-also

IKsControl

IKsReferenceClock

KsFilterGetOuterUnknown

KsGetOuterUnknown

KsPinGetConnectedFilterInterface

KsPinGetConnectedPinInterface

KsPinSetPinClockTime

KsRegisterAggregatedClientUnknown