Interface IKsReferenceClock (ks.h)

Article
02/29/2024

L’interface IKsReferenceClock est une interface de style COM fournie par AVStream sur toutes les broches. L’épingle transmet la requête à l’horloge master.

Héritage

L’interface IKsReferenceClock hérite de l’interface IUnknown.

Méthodes

L’interface IKsReferenceClock possède ces méthodes.


IKsReferenceClock ::GetCorrelatedPhysicalTime La méthode IKsReferenceClock ::GetCorrelatedPhysicalTime interroge l’horloge de référence associée pour l’heure physique actuelle et récupère l’heure système corrélée.
IKsReferenceClock ::GetCorrelatedTime La méthode IKsReferenceClock ::GetCorrelatedTime interroge l’horloge de référence associée pour l’heure actuelle du flux et acquiert l’heure système corrélée.
IKsReferenceClock ::GetPhysicalTime La méthode IKsReferenceClock ::GetPhysicalTime interroge l’horloge de référence associée pour l’heure physique actuelle.
IKsReferenceClock ::GetResolution La méthode IKsReferenceClock ::GetResolution interroge l’horloge de référence associée pour sa résolution.
IKsReferenceClock ::GetState La méthode IKsReferenceClock ::GetState interroge l’horloge de référence associée pour son état de streaming actuel.
IKsReferenceClock ::GetTime La méthode IKsReferenceClock ::GetTime interroge l’horloge de référence associée pour l’heure actuelle.

Remarques

Le minidriver peut acquérir une interface IKsReferenceClock en appelant KsPinGetReferenceClockInterface. Étant donné qu’il s’agit d’une interface de style COM, KsPinGetReferenceClockInterface appelle QueryInterface, qui appelle à son tour AddRef pour incrémenter le pointeur d’interface. Cela signifie que lorsque le minidriver est terminé avec l’interface IKsReferenceClock , le minidriver doit le libérer en appelant Release.

Les clients écrits en C verront l’interface IKsReferenceClock comme une structure qui contient un pointeur vers une table de fonctions au lieu d’une classe de base abstraite C++. Un client écrit en C++ peut effectuer les opérations suivantes :

PIKSREFERENCECLOCK RefClock;

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

Toutefois, un client écrit en C effectuerait les opérations suivantes à la place :

PIKSREFERENCECLOCK RefClock;

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

Pour plus d’informations, consultez Vue d’ensemble d’AVStream.