RxAcquireExclusiveFcbResourceInMRx, fonction (mrxfcb.h)

Article
02/07/2025

RxAcquireExclusiveFcbResourceInMRx acquiert la ressource FCB pour un pilote de mini-redirecteur réseau en mode exclusif. Cette routine attend que la ressource FCB soit gratuite si elle a été acquise précédemment et ne retourne pas de contrôle tant que la ressource exclusive n’a pas été acquise.

Syntaxe

NTSTATUS RxAcquireExclusiveFcbResourceInMRx(
  PMRX_FCB Fcb
);

Paramètres

Fcb

Pointeur vers le FCB. Ce paramètre est obligatoire et ne peut pas être NULL.

Valeur de retour

RxAcquireExclusiveFcbResourceInMRx retourne STATUS_SUCCESS en cas de réussite ou l’un des codes d’erreur suivants en cas d’échec :

Retourner le code	Description
STATUS_LOCK_NOT_GRANTED	La ressource FCB n’a pas été acquise.

Remarques

Les ressources de synchronisation intéressantes pour un pilote de mini-redirecteur réseau sont principalement associées au FCB. Il existe une ressource d’E/S de pagination et une ressource régulière. La ressource d’E/S de pagination est gérée en interne par RDBSS. La seule ressource accessible à un pilote de mini-redirecteur réseau est la ressource régulière accessible à l’aide de RxAcquireExclusiveFcbResourceInMRx, RxAcquireExclusiveFcbResourceInMRxEx, ou RxAcquireSharedFcbResourceInMRx, en fonction du mode acquis souhaité.

RxAcquireExclusiveFcbResourceInMRx attend que la ressource FCB soit gratuite si elle a été précédemment acquise et ne retourne pas le contrôle tant que la ressource exclusive n’a pas été acquise. Cette routine acquiert la ressource FCB même si le RX_CONTEXT associé à ce FCB a été annulé.

Une ressource FCB acquise avec RxAcquireExclusiveFcbResourceInMRx doit être libérée en appelant RxReleaseFcbResourceInMRx ou RxReleaseFcbResourceForThreadInMRx.