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 |