Interface IKsReferenceClock (ks.h)

Artigo
08/07/2023

A interface IKsReferenceClock é uma interface de estilo COM fornecida pelo AVStream em todos os pinos. O pino passa a solicitação para o relógio master.

Herança

A interface IKsReferenceClock herda da interface IUnknown .

Métodos

A interface IKsReferenceClock tem esses métodos.


IKsReferenceClock::GetCorrelatedPhysicalTime O método IKsReferenceClock::GetCorrelatedPhysicalTime consulta o relógio de referência associado para a hora física atual e recupera a hora correlacionada do sistema.
IKsReferenceClock::GetCorrelatedTime O método IKsReferenceClock::GetCorrelatedTime consulta o relógio de referência associado para o tempo de fluxo atual e adquire a hora correlacionada do sistema.
IKsReferenceClock::GetPhysicalTime O método IKsReferenceClock::GetPhysicalTime consulta o relógio de referência associado para a hora física atual.
IKsReferenceClock::GetResolution O método IKsReferenceClock::GetResolution consulta o relógio de referência associado para sua resolução.
IKsReferenceClock::GetState O método IKsReferenceClock::GetState consulta o relógio de referência associado para seu estado de streaming atual.
IKsReferenceClock::GetTime O método IKsReferenceClock::GetTime consulta o relógio de referência associado para a hora atual.

Comentários

O minidriver pode adquirir uma interface IKsReferenceClock chamando KsPinGetReferenceClockInterface. Como essa é uma interface de estilo COM, KsPinGetReferenceClockInterface chama QueryInterface, que, por sua vez, invoca AddRef para incrementar o ponteiro da interface. Isso significa que, quando o minidriver é concluído com a interface IKsReferenceClock , o minidriver deve liberá-lo chamando Release.

Os clientes escritos em C verão a interface IKsReferenceClock como uma estrutura que contém um ponteiro para uma tabela de funções em vez de uma classe base abstrata C++. Um cliente escrito em C++ pode fazer o seguinte:

PIKSREFERENCECLOCK RefClock;

if (NT_SUCCESS (
  KsPinGetReferenceClockInterface (
    Pin,
    &RefClock)
) {
    ... RefClock -> GetCorrelatedTime (...);
    RefClock -> Release ();
}

No entanto, um cliente escrito em C faria o seguinte:

PIKSREFERENCECLOCK RefClock;

If (NT_SUCCESS (
  KsPinGetReferenceClockInterface (
    Pin,
    &RefClock)
) {
  ... RefClock -> lpVtbl -> GetCorrelatedTime (...);
  RefClock -> lpVtbl -> Release ();
}

Para obter mais informações, consulte Visão geral do AVStream.