Funzione ExInitializeRundownProtection (wdm.h)
La routine ExInitializeRundownProtection inizializza la protezione da run-down in un oggetto condiviso.
Sintassi
void ExInitializeRundownProtection(
[out] PEX_RUNDOWN_REF RunRef
);
Parametri
[out] RunRef
Puntatore a una struttura di EX_RUNDOWN_REF allocata dal chiamante che deve essere inizializzata. L'allocazione deve essere allineata a 4 byte su piattaforme a 32 bit e allineate a 8 byte su piattaforme a 64 bit. Per altre informazioni, vedere la sezione Osservazioni.
Valore restituito
nessuno
Osservazioni
Questa routine viene chiamata dal driver che possiede un oggetto che risiede nella memoria condivisa ed è accessibile da altri driver.
ExInitializeRundownProtection deve essere chiamato per inizializzare una struttura EX_RUNDOWN_REF prima di passare come parametro a qualsiasi altra routine di protezione in esecuzione.
Le routine di protezione da run-down usano 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 numero di istanze di protezione da run-down attualmente effettive sull'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 le routine ExAcquireRundownProtection e ExReleaseRundownProtection per acquisire e rilasciare la protezione in fase di rilascio nell'oggetto.
Per altre informazioni, vedere Run-Down Protection.
Requisiti
| 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 |