Funzione ExInitializeRundownProtection (wdm.h)
La routine ExInitializeRundownProtection inizializza la protezione dell'esecuzione in un oggetto condiviso.
Sintassi
void ExInitializeRundownProtection(
[out] PEX_RUNDOWN_REF RunRef
);
Parametri
[out] RunRef
Puntatore a una struttura EX_RUNDOWN_REF allocata dal chiamante che deve essere inizializzata. L'allocazione deve essere allineata a 4 byte su piattaforme a 32 bit e allineata a 8 byte su piattaforme a 64 bit. Per altre informazioni, vedere Osservazioni.
Valore restituito
Nessuno
Osservazioni
Questa routine viene chiamata dal driver proprietario di un oggetto che risiede nella memoria condivisa ed è accessibile da altri driver.
exInitializeRundownProtection deve essere chiamato per inizializzare una struttura di EX_RUNDOWN_REF prima che venga passata come parametro a qualsiasi altra routine di protezione di run-down.
Le routine di protezione da run-down utilizzano la struttura EX_RUNDOWN_REF per tenere traccia dello stato di esecuzione di un oggetto condiviso associato alla struttura. Queste informazioni sullo stato includono un conteggio delle istanze di protezione di run-down attualmente applicate all'oggetto. ExInitializeRundownProtection inizializza questo conteggio su zero.
Dopo l'inizializzazione di una struttura EX_RUNDOWN_REF, altri driver che accedono all'oggetto associato possono chiamare la ExAcquireRundownProtection e routine di exReleaseRundownProtection per acquisire e rilasciare la protezione di esecuzione nell'oggetto.
Per altre informazioni, vedere Run-Down Protection.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Disponibile a partire da Windows XP. |
| piattaforma di destinazione | Universale |
| intestazione | wdm.h (include Wdm.h) |
| libreria | NtosKrnl.lib |
| dll | NtosKrnl.exe |
| IRQL | <= APC_LEVEL |