Funzione ExInitializeRundownProtection (wdm.h)

  • Articolo

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

Vedi anche

EX_RUNDOWN_REF

ExAcquireRundownProtection

ExReleaseRundownProtection