Funzione RxFinalizeNetRoot (fcb.h)
RxFinalizeNetRoot finalizza la struttura di NET_ROOT specificata. Il chiamante deve avere un blocco esclusivo sulla tabella netname associata all'oggetto dispositivo.
Sintassi
BOOLEAN RxFinalizeNetRoot(
[out] OUT PNET_ROOT ThisNetRoot,
[in] IN BOOLEAN RecursiveFinalize,
[in] IN BOOLEAN ForceFinalize
);
Parametri
[out] ThisNetRoot
Puntatore alla struttura NET_ROOT da finalizzare.
[in] RecursiveFinalize
Valore che indica se la finalizzazione deve essere eseguita in modo ricorsivo.
[in] ForceFinalize
Valore che indica se la finalizzazione deve essere forzata, indipendentemente dal conteggio dei riferimenti.
Se ForceFinalize è FALSE, il membro NodeReferenceCount della struttura NET_ROOT a cui punta ThisNetRoot deve essere 1 affinché il NET_ROOT venga finalizzato.
Valore restituito
RxFinalizeNetRoot restituisce TRUE in caso di esito positivo o FALSE se non è stata eseguita la finalizzazione: se è già in corso una finalizzazione del NET_ROOT, RxFinalizeNetRoot restituirà FALSE.
Osservazioni
La routine RxFinalizeNetRoot non viene chiamata direttamente dai driver del mini-redirector di rete. RDBSS chiama internamente questa routine quando il conteggio dei riferimenti sul NET_ROOT viene decrementato su 1.
Prima di chiamare RxFinalizeNetRoot, è necessario acquisire in modalità esclusiva un blocco sulla tabella netname associata all'oggetto dispositivo.
Se il parametro RecursiveFinalize è TRUE, RxFinalizeNetRoot ripulirà tutte le strutture FCB orfane associate a questa NET_ROOT. Questi fcb orfani sono strutture in cui il membro fcbState ha il flag di FCB_STATE_ORPHANED impostato.
Fabbisogno
| Requisito | Valore |
|---|---|
| piattaforma di destinazione | Desktop |
| intestazione | fcb.h (include Fcb.h, Mrxfcb.h) |
| IRQL | <= APC_LEVEL |