Função KsPinGetReferenceClockInterface (ks.h)

A função KsPinGetReferenceClockInterface retorna uma interface de estilo COM para o relógio de referência associado a Pin. Esse ponteiro de interface será um interface de IKsReferenceClock.

Sintaxe

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

Parâmetros

[in] Pin

Um ponteiro para a estrutura de KSPIN para a qual retornar a interface do relógio de referência.

[out] Interface

Um ponteiro para um local de memória que recebe o endereço de uma interface de IKsReferenceClock. Esta é uma interface de estilo COM com uma contagem de referência associada. Os minidrivers devem liberar a interface quando terminarem com ela.

Valor de retorno

KsPinGetReferenceClockInterface retorna STATUS_SUCCESS e deposita o endereço da interface IKsReferenceClock no Interface se o pino implementar o relógio ou tiver recebido notificação do relógio mestre pela propriedade KSPROPERTY_STREAM_MASTERCLOCK. Retorna STATUS_DEVICE_NOT_READY se o pino ainda não recebeu notificação do relógio mestre.

Observações

O momento mais comum para chamar KsPinGetReferenceClockInterface está em uma transição de estado para KSSTATE_ACQUIRE.

Consulte de Relógios AVStream para obter mais informações sobre como usar a interface de IKsReferenceClock retornada por essa rotina.

Requisitos

Consulte também

IKsControl

IKsReferenceClock

KsFilterGetOuterUnknown

KsGetOuterUnknown

KsPinGetConnectedFilterInterface

KsPinGetConnectedPinInterface

KsPinSetPinClockTime

KsRegisterAggregatedClientUnknown