RxFinalizeNetFobx, fonction (fcb.h)

Article
02/29/2024

RxFinalizeNetFOBX finalise la structure FOBX donnée. L’appelant doit avoir un verrou exclusif sur le FCB associé à 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 a la valeur FALSE, le membre NodeReferenceCount de la structure FOBX pointée par ThisFobx doit être 0 pour que le FOBX soit finalisé.

Valeur retournée

RxFinalizeNetFOBX retourne TRUE en cas de réussite ou FALSE si la finalisation n’a pas eu lieu :

Remarques

La routine RxFinalizeNetFOBX n’est normalement pas appelée directement par les pilotes de mini-redirecteur réseau. RDBSS appelle cette routine en interne lorsqu’un paquet de demande d’E/S est reçu pour IRP_MJ_CLOSE. Ce 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 de la mémoire pour le FOBX si le mini-redirecteur réseau prend en charge cette routine.