Funzione KsPinGetReferenceClockInterface (ks.h)
La funzione KsPinGetReferenceClockInterface restituisce un'interfaccia di stile COM all'orologio di riferimento associato a 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 una posizione 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 dell'operazione.
Valore restituito
KsPinGetReferenceClockInterface restituisce STATUS_SUCCESS e deposita l'indirizzo dell'interfaccia IKsReferenceClock in Interface se il pin implementa l'orologio o ha ricevuto una 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.
Osservazioni
Il tempo più comune per chiamare KsPinGetReferenceClockInterface è in una transizione di stato a KSSTATE_ACQUIRE.
Per altre informazioni sull'uso dell'interfaccia IKsReferenceClock, vedere clock AVStream.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Disponibile in Microsoft Windows XP e nei sistemi operativi successivi e in DirectX 8.0 e versioni successive di DirectX. |
| piattaforma di destinazione | Universale |
| intestazione | ks.h (include Ks.h) |
| libreria | Ks.lib |
| IRQL | PASSIVE_LEVEL |