Fonction ExInitializeRundownProtection (wdm.h)

  • Article

La routine ExInitializeRundownProtection initialise la protection d’exécution sur un objet partagé.

Syntaxe

void ExInitializeRundownProtection(
  [out] PEX_RUNDOWN_REF RunRef
);

Paramètres

[out] RunRef

Pointeur vers une structure de EX_RUNDOWN_REF allouée par l’appelant qui doit être initialisée. L’allocation doit être alignée sur 4 octets sur les plateformes 32 bits et 8 octets sur les plateformes 64 bits. Pour plus d'informations, consultez la section Notes.

Valeur de retour

None

Remarques

Cette routine est appelée par le pilote qui possède un objet qui réside dans la mémoire partagée et qui est accessible par d’autres pilotes.

ExInitializeRundownProtection doit être appelé pour initialiser une structure de EX_RUNDOWN_REF avant qu’elle ne soit transmise en tant que paramètre à toute autre routine de protection d’exécution.

Les routines de protection d’exécution utilisent la structure EX_RUNDOWN_REF pour suivre les status d’exécution d’un objet partagé associé à la structure. Ces informations status incluent le nombre d’instances de protection contre l’exécution qui sont actuellement en vigueur sur l’objet. ExInitializeRundownProtection initialise ce nombre à zéro.

Une fois qu’une structure de EX_RUNDOWN_REF est initialisée, d’autres pilotes qui accèdent à l’objet associé peuvent appeler les routines ExAcquireRundownProtection et ExReleaseRundownProtection pour acquérir et libérer la protection contre l’exécution sur l’objet.

Pour plus d’informations, consultez Protection contre les pannes.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Disponible à partir de Windows XP.
Plateforme cible Universal
En-tête wdm.h (inclure Wdm.h)
Bibliothèque NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= APC_LEVEL

Voir aussi

EX_RUNDOWN_REF

ExAcquireRundownProtection

ExReleaseRundownProtection