KsCreateDefaultClock, fonction (ks.h)
Étant donné une requête IRP_MJ_CREATE, la fonction KsCreateDefaultClock crée une horloge par défaut qui utilise l’horloge système comme base de temps et associe l’ioGetCurrentIrpStackLocation(Irp)->FileObject à l’horloge à l’aide d’une table de répartition interne (KSDISPATCH_TABLE). Ne termine pas l’IRP ou définit l’état dans l’IRP.
La fonction KsCreateDefaultClock ne peut être appelée qu’à PASSIVE_LEVEL.
Syntaxe
KSDDKAPI NTSTATUS KsCreateDefaultClock(
[in] PIRP Irp,
[in] PKSDEFAULTCLOCK DefaultClock
);
Paramètres
[in] Irp
Spécifie l’IRP avec la requête de création d’horloge en cours de traitement.
[in] DefaultClock
Spécifie une structure d’horloge par défaut initialisée qui est partagée entre n’importe quelle instance de l’horloge par défaut pour le parent.
Valeur de retour
La fonction KsCreateDefaultClock retourne STATUS_SUCCESS en cas de réussite, ou une erreur en cas d’échec.
Remarques
L’horloge peut être créée après avoir utilisé KsAllocateDefaultClock pour créer et initialiser les structures internes pour une instance d’horloge par défaut. Après l’initialisation, de nombreux objets de fichier peuvent être créés sur la même instance d’horloge par défaut sous-jacente.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Universel |
| d’en-tête | ks.h (include Ks.h) |
| bibliothèque | Ks.lib |