Fonction RxAcquireExclusiveFcbResourceInMRx (mrxfcb.h)

Article
02/26/2024

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é précédemment acquise et ne retourne pas le 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 avoir la valeur NULL.

Valeur retournée

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

Code de retour	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 standard qui doit être accessible à l’aide de RxAcquireExclusiveFcbResourceInMRx, RxAcquireExclusiveFcbResourceInMRxEx ou RxAcquireSharedFcbResourceInMRx, selon le mode acquis souhaité.

RxAcquireExclusiveFcbResourceInMRx attend que la ressource FCB soit libre si elle a été acquise précédemment 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.