Condividi tramite


Funzione KsPinGetReferenceClockInterface (ks.h)

La funzione KsPinGetReferenceClockInterface restituisce un'interfaccia di stile COM all'orologio di riferimento associato al Pin. Questo puntatore di interfaccia sarà un'interfaccia IKsReferenceClock .

Sintassi

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

Parametri

[in] Pin

Puntatore alla struttura KSPIN per cui restituire l'interfaccia dell'orologio di riferimento.

[out] Interface

Puntatore a un percorso di memoria che riceve l'indirizzo di un'interfaccia IKsReferenceClock . Si tratta di un'interfaccia di stile COM con un conteggio dei riferimenti associato. I minidriver devono rilasciare l'interfaccia al termine.

Valore restituito

KsPinGetReferenceClockInterface restituisce STATUS_SUCCESS e deposita l'indirizzo dell'interfaccia IKsReferenceClocknell'interfaccia se il pin implementa l'orologio o ha ricevuto la notifica dell'orologio master tramite la proprietà KSPROPERTY_STREAM_MASTERCLOCK . Restituisce STATUS_DEVICE_NOT_READY se il pin non ha ancora ricevuto la notifica dell'orologio master.

Commenti

Il tempo più comune per chiamare KsPinGetReferenceClockInterface è in una transizione di stato a KSSTATE_ACQUIRE.

Per altre informazioni sull'uso dell'interfaccia IKsReferenceClock, vedere Orologi AVStream restituiti da questa routine.

Requisiti

Requisito Valore
Client minimo supportato Disponibile in Microsoft Windows XP e versioni successive e DirectX 8.0 e versioni successive di DirectX.
Piattaforma di destinazione Universale
Intestazione ks.h (include Ks.h)
Libreria Ks.lib
IRQL PASSIVE_LEVEL

Vedi anche

IKsControl

IKsReferenceClock

KsFilterGetOuterUnknown

KsGetOuterUnknown

KsPinGetConnectedFilterInterface

KsPinGetConnectedPinInterface

KsPinSetPinClockTime

KsRegisterAggregatedClientUnknown