Funzione RxFinalizeSrvCall (fcb.h)

Articolo
02/29/2024

RxFinalizeSrvCall finalizza la struttura di SRV_CALL specificata. Il chiamante deve avere un blocco esclusivo sulla tabella netname associata all'oggetto dispositivo.

Sintassi

BOOLEAN RxFinalizeSrvCall(
  [out] OUT PSRV_CALL ThisSrvCall,
  [in]  IN BOOLEAN    ForceFinalize
);

Parametri

[out] ThisSrvCall

Puntatore alla struttura SRV_CALL da finalizzare.

[in] ForceFinalize

Valore che indica se la finalizzazione deve essere forzata, indipendentemente dal conteggio dei riferimenti.

Se ForceFinalize è FALSE, il membro NodeReferenceCount della struttura SRV_CALL a cui punta ThisSrvCall deve essere 1 affinché il SRV_CALL venga finalizzato.

Valore restituito

RxFinalizeSrvCall restituisceTRUE in caso di esito positivo o FALSE se la finalizzazione non si è verificata:

Commenti

La routine RxFinalizeSrvCall non viene in genere chiamata direttamente dai driver mini-redirector di rete. RDBSS chiama questa routine internamente quando il conteggio dei riferimenti sul SRV_CALL viene decrementato su 1. RDBSS chiama anche RxFinalizeSrvCall quando il driver del mini-redirector di rete viene arrestato o scaricato.

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

Se l'ID del processo in esecuzione corrente corrisponde all'ID del processo RDBSS, verrà inviato un thread di lavoro ritardato per eliminare definitivamente la struttura SRV_CALL. Questo thread di lavoro chiamerà successivamente la routine MRxFinalizeSrvCall fornita dal mini-redirector di rete per finalizzare il SRV_CALL. In caso contrario, la routine MRxFinalizeSrvCall verrà chiamata direttamente per finalizzare il SRV_CALL.