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 partagée allouée par 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 à l’utilisation du système.
Valeur de retour
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é lorsque 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 une 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 les ressources allouées pour une utilisation avec l’horloge.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Universel |
| d’en-tête | ks.h (include Ks.h) |
| bibliothèque | Ks.lib |
| IRQL | PASSIVE_LEVEL |