Funzione RxFinalizeNetRoot (fcb.h)

Articolo
04/30/2024

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 restituisceTRUE in caso di esito positivo o FALSE se la finalizzazione non si verifica: se è già in corso una finalizzazione del NET_ROOT, RxFinalizeNetRoot restituirà FALSE.

Commenti

La routine RxFinalizeNetRoot non viene in genere chiamata direttamente dai driver mini-redirector di rete. RDBSS chiama questa routine internamente quando il conteggio dei riferimenti sul NET_ROOT viene decrementato su 1.

Prima di chiamare RxFinalizeNetRoot, è necessario acquisire un blocco sulla tabella netname associata all'oggetto dispositivo in modalità esclusiva.

Se il parametro RecursiveFinalize è TRUE, RxFinalizeNetRoot elimina 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 su .