Fonction RxDereference (rxprocs.h)

Article
07/02/2025

RxDereference décrémente le membre NodeReferenceCount d’une structure par un pour plusieurs structures de données comptées de référence utilisées par RDBSS.

Syntaxe

void RxDereference(
  [in, out] IN OUT PVOID          Instance,
  [in]      IN LOCK_HOLDING_STATE LockHoldingState
);

Paramètres

[in, out] Instance

Pointeur vers la structure de données comptée par référence à déréférer.

[in] LockHoldingState

Mode dans lequel le verrou approprié pour cette structure de données est conservé. Ce paramètre peut être l’une des valeurs suivantes pour l’énumération LOCK_HOLDING_STATE :

LHS_LockNotHeld

Un verrou n’est pas conservé actuellement.

LHS_SharedLockHeld

Un verrou partagé est conservé.

LHS_ExclusiveLockHeld

Un verrou exclusif est détenu.

Valeur de retour

Aucun

Remarques

RxDereference pouvez être utilisé pour déréférencer (décrémenter par un) le membre NodeReferenceCount sur les structures de données suivantes utilisées par RDBSS :

SRV_CALL

NET_ROOT

V_NET_ROOT

SRV_OPEN

FOBX

Si RxDereference est appelée avec n’importe quel autre type de structure de données RDBSS, la routine entraîne l’assertion du système sur les builds vérifiées.

Si le membre NodeReferenceCount est inférieur à 0 après avoir été déréféré (décrémenté) par RxDereference, RxDereference provoque l’assertion du système sur les builds vérifiées.

Si le NodeReferenceCount les décréments de membre sur 1 et que le paramètre LockHoldingState a été LHS_ExclusiveLockHeld, l’instance de la structure de données peut être finalisée immédiatement. Sinon, l’instance de la structure de données est marquée pour être délimitée et finalisée ultérieurement.