Fonction RxpDereferenceNetFcb (fcb.h)
RxpDereferenceNetFcb décrémente le nombre de références sur une structure FCB.
Syntaxe
LONG RxpDereferenceNetFcb(
PFCB Fcb
);
Paramètres
Fcb
Pointeur vers la structure FCB à déréférer.
Valeur retournée
RxpDereferenceNetFcb retourne le nombre de références final après la déréférence.
Remarques
Le référencement et le déréférencement des bases de données sont différents de ceux des autres structures de données en raison de la ressource incorporée dans le fcB. Cela implique que l’appelant a besoin d’informations sur la status du FCB (qu’elle ait été finalisée ou non ). Pour finaliser le fcb, deux verrous doivent être conservés : le verrou de table de nom NET_ROOT ainsi que la ressource FCB. Ces considérations conduisent à une approche différente dans la déréférencement des fcbs. Par conséquent, RxpDereferenceNetFcb ne tente pas de finaliser le FCB.
Un certain nombre de macros sont définies dans fcb.h pour le débogage qui constituent le moyen préféré d’appeler cette routine. Ces macros fournissent un wrapper autour des routines RxpReferenceNetFcb ou RxpDereferenceNetFcb utilisées pour les opérations de gestion de la structure de fichiers sur les structures FCB. La macro RxDereferenceNetFcb est la méthode recommandée pour appeler cette routine. Cette macro appelle d’abord la routine RxpTrackDereference pour consigner les informations de diagnostic sur la demande avant d’appeler la routine RxpDereferenceNetFcb .
Sur les builds vérifiées, RxpDereferenceNetFcb oblige le système à ASSERT si le type de nœud de la structure n’est pas un FCB ou si le nombre de références final est inférieur à 0.
Configuration requise
Condition requise | Valeur |
---|---|
Plateforme cible | Desktop (Expérience utilisateur) |
En-tête | fcb.h (inclure Fcb.h) |
IRQL | <= APC_LEVEL |