Fonction ExInitializeRundownProtection (wdm.h)
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 |