KsPinGetReferenceClockInterface, fonction (ks.h)
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 quand elle est terminée.
Valeur de retour
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 la notification de l’horloge principale via la propriété KSPROPERTY_STREAM_MASTERCLOCK. Retourne STATUS_DEVICE_NOT_READY si l’épingle n’a pas encore reçu de notification de l’horloge principale.
Remarques
Le moment le plus courant d’appeler KsPinGetReferenceClockInterface est dans une transition d’état vers KSSTATE_ACQUIRE.
Consultez 'horloges AVStream pour plus d’informations sur l’utilisation de l’interface IKsReferenceClock retournée par cette routine.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum 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 | Universel |
| d’en-tête | ks.h (include Ks.h) |
| bibliothèque | Ks.lib |
| IRQL | PASSIVE_LEVEL |