KsPinGetReferenceClockInterface-Funktion (ks.h)

Die KsPinGetReferenceClockInterface--Funktion gibt eine COM-Formatschnittstelle zur Referenzuhr zurück, die Pin-zugeordnet ist. Dieser Schnittstellenzeiger ist ein IKsReferenceClock Schnittstelle.

Syntax

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

Parameter

[in] Pin

Ein Zeiger auf die KSPIN Struktur, für die die Referenzuhrschnittstelle zurückgegeben werden soll.

[out] Interface

Ein Zeiger auf einen Speicherspeicherort, der die Adresse eines IKsReferenceClock Schnittstelle empfängt. Dies ist eine COM-Stilschnittstelle mit einer zugeordneten Verweisanzahl. Minidriver müssen die Schnittstelle freigeben, wenn sie damit fertig ist.

Rückgabewert

KsPinGetReferenceClockInterface gibt STATUS_SUCCESS zurück und legt die Adresse der IKsReferenceClock Schnittstelle in Interface zurück, wenn der Pin die Uhr implementiert oder die Benachrichtigung über die Masteruhr über die eigenschaft KSPROPERTY_STREAM_MASTERCLOCK empfangen hat. Gibt STATUS_DEVICE_NOT_READY zurück, wenn der Pin noch keine Benachrichtigung über die Masteruhr erhalten hat.

Bemerkungen

Die häufigste Zeit zum Aufrufen KsPinGetReferenceClockInterface- befindet sich in einem Zustandsübergang zu KSSTATE_ACQUIRE.

Weitere Informationen zur Verwendung der IKsReferenceClock Schnittstelle, die von dieser Routine zurückgegeben wird, finden Sie unter AVStream Clocks.

Anforderungen

Siehe auch

IKsControl-

IKsReferenceClock

KsFilterGetOuterUnknown

KsGetOuterUnknown-

KsPinGetConnectedFilterInterface

KsPinGetConnectedPinInterface

KsPinSetPinClockTime-

KsRegisterAggregatedClientUnknown