KsPinGetReferenceClockInterface, fonction (ks.h)

Article
02/26/2024

La fonction KsPinGetReferenceClockInterface retourne une interface de style COM à l’horloge de référence associée à Pin. Ce pointeur d’interface sera une interface IKsReferenceClock .

Syntaxe

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

Paramètres

[in] Pin

Pointeur vers la structure KSPIN pour laquelle retourner l’interface d’horloge de référence.

[out] Interface

Pointeur vers un emplacement de mémoire qui reçoit l’adresse d’une interface IKsReferenceClock . Il s’agit d’une interface de style COM avec un nombre de références associé. Les minidrivers doivent libérer l’interface lorsqu’ils en ont terminé.

Valeur retournée

KsPinGetReferenceClockInterface retourne STATUS_SUCCESS et dépose l’adresse de l’interface IKsReferenceClock dans Interface si la broche implémente l’horloge ou a reçu une notification de l’horloge master par le biais de la propriété KSPROPERTY_STREAM_MASTERCLOCK. Retourne STATUS_DEVICE_NOT_READY si la broche n’a pas encore reçu de notification de l’horloge master.

Remarques

Le moment le plus courant pour appeler KsPinGetReferenceClockInterface est dans une transition d’état vers KSSTATE_ACQUIRE.

Pour plus d’informations sur l’utilisation de l’interface IKsReferenceClock retournée par cette routine, consultez Horloges AVStream.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible dans Microsoft Windows XP et les systèmes d’exploitation ultérieurs et DirectX 8.0 et versions ultérieures de DirectX.
Plateforme cible	Universal
En-tête	ks.h (inclure Ks.h)
Bibliothèque	Ks.lib
IRQL	PASSIVE_LEVEL