RxFinalizeNetFobx, fonction (fcb.h)

Article
02/06/2025

RxFinalizeNetFOBX finalise la structure FOBX donnée. L’appelant doit disposer d’un verrou exclusif sur la structure FCB associée à la structure FOBX.

Syntaxe

BOOLEAN RxFinalizeNetFobx(
  [out] OUT PFOBX  ThisFobx,
  [in]  IN BOOLEAN RecursiveFinalize,
  [in]  IN BOOLEAN ForceFinalize
);

Paramètres

[out] ThisFobx

Pointeur vers la structure FOBX à finaliser.

[in] RecursiveFinalize

Valeur indiquant si la finalisation doit être effectuée de manière récursive. Ce paramètre n’est actuellement pas utilisé.

[in] ForceFinalize

Valeur indiquant si la finalisation doit être forcée, quel que soit le nombre de références.

Si ForceFinalize est FALSE, le NodeReferenceCount membre de la structure FOBX pointée par ThisFobx doit être 0 pour que le FOBX soit finalisé.

Valeur de retour

RxFinalizeNetFOBX retourne TRUE sur succès ou FAUX si la finalisation n’a pas eu lieu :

Remarques

La routine RxFinalizeNetFOBX n’est normalement pas appelée par les pilotes de mini-redirecteur réseau directement. RDBSS appelle cette routine en interne lorsqu’un paquet de requête d’E/S est reçu pour IRP_MJ_CLOSE. Ce protocole IRP est normalement reçu par RDBSS en réponse à une application en mode utilisateur demandant une opération de fermeture de fichier. Il est également possible pour un autre pilote de noyau d’émettre un tel IRP.

Avant d’appeler RxFinalizeNetFOBX, un verrou sur la structure FCB doit être acquis en mode exclusif.

La routine RxFinalizeNetFOBX appelle la routine MRxDeallocateForFobx fournie par le mini-redirecteur réseau pour libérer la mémoire du FOBX si le mini-redirecteur réseau prend en charge cette routine.