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

Voir aussi

KsAllocateDefaultClock