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 |