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á uma interface IKsReferenceClock .
Sintaxe
KSDDKAPI NTSTATUS KsPinGetReferenceClockInterface(
[in] PKSPIN Pin,
[out] PIKSREFERENCECLOCK *Interface
);
Parâmetros
[in] Pin
Um ponteiro para a estrutura 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 IKsReferenceClock . Essa é uma interface de estilo COM com uma contagem de referência associada. Os minidrivers devem liberar a interface quando terminarem com ela.
Retornar valor
KsPinGetReferenceClockInterface retorna STATUS_SUCCESS e deposita o endereço da interface IKsReferenceClock em Interface se o pino implementar o relógio ou tiver recebido notificação do relógio master por meio da propriedade KSPROPERTY_STREAM_MASTERCLOCK. Retorna STATUS_DEVICE_NOT_READY se o pino ainda não recebeu notificação do relógio master.
Comentários
O momento mais comum para chamar KsPinGetReferenceClockInterface é em uma transição de estado para KSSTATE_ACQUIRE.
Consulte Relógios AVStream para obter mais informações sobre como usar a interface IKsReferenceClock retornada por essa rotina.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Disponível no Microsoft Windows XP e em sistemas operacionais posteriores e no DirectX 8.0 e versões posteriores do DirectX. |
| Plataforma de Destino | Universal |
| Cabeçalho | ks.h (inclua Ks.h) |
| Biblioteca | Ks.lib |
| IRQL | PASSIVE_LEVEL |