Partager via


ExInitializeRundownProtection, fonction (wdm.h)

L'ExInitializeRundownProtection routine 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 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 alignée sur des plateformes 64 bits. Pour plus d’informations, consultez Remarques.

Valeur de retour

Aucun

Remarques

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

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

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

Une fois qu’une structure 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 d’exécution sur l’objet.

Pour plus d’informations, consultez Run-Down Protection.

Exigences

Exigence Valeur
client minimum pris en charge Disponible à partir de Windows XP.
plateforme cible Universel
d’en-tête wdm.h (include Wdm.h)
bibliothèque NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= APC_LEVEL

Voir aussi

EX_RUNDOWN_REF

ExAcquireRundownProtection

ExReleaseRundownProtection