KsCreateDefaultClock, fonction (ks.h)
Suite à une demande de 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’objet IoGetCurrentIrpStackLocation(Irp)->FileObject à l’horloge à l’aide d’une table de répartition interne (KSDISPATCH_TABLE). Ne termine pas l’IRP ou ne définit pas le status 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 demande 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 quel instance de l’horloge par défaut pour le parent.
Valeur retournée
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 d’une horloge par défaut instance. 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.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Universal |
| En-tête | ks.h (inclure Ks.h) |
| Bibliothèque | Ks.lib |