KsAllocateDefaultClock, fonction (ks.h)

La fonction KsAllocateDefaultClock alloue et initialise la structure d’horloge par défaut.

Syntaxe

KSDDKAPI NTSTATUS KsAllocateDefaultClock(
  [out] PKSDEFAULTCLOCK *DefaultClock
);

Paramètres

[out] DefaultClock

Spécifie la structure d’horloge partagée par défaut allouée à l’appelant. L’heure actuelle est définie sur zéro et l’état est défini sur KSSTATE_STOP. Une fois cette routine terminée, la structure indiquée par ce pointeur contient une référence à l’horloge par défaut. Les données retournées doivent être traitées comme opaques et réservées à une utilisation système.

Valeur retournée

La fonction KsAllocateDefaultClock retourne STATUS_SUCCESS en cas de réussite ou une erreur de mémoire en cas d’échec.

Remarques

L’élément DefaultClock.ReferenceCount interne est initialisé en un par la fonction KsAllocateDefaultClock . L’élément est incrémenté et décrémenté à mesure que chaque DPC de notification est mis en file d’attente et terminé. Lorsque la structure doit être libérée, l’élément est utilisé pour déterminer si le propriétaire de l’horloge doit libérer la structure ou si un DPC en attente doit la libérer de manière asynchrone.

Lorsque l’horloge n’est plus nécessaire, le pilote doit appeler KsFreeDefaultClock pour libérer toutes les ressources allouées à l’utilisation avec l’horloge.

Configuration requise

Voir aussi

KsAllocateDefaultClockEx

KsFreeDefaultClock