RxAcquireSharedFcbResourceInMRx, fonction (mrxfcb.h)

Article
02/07/2025

RxAcquireSharedFcbResourceInMRx acquiert la ressource FCB pour un pilote de mini-redirecteur réseau en mode partagé. Cette routine attend que la ressource FCB soit gratuite si elle a été acquise exclusivement et ne retourne pas de contrôle tant que la ressource partagée n’a pas été acquise.

Syntaxe

NTSTATUS RxAcquireSharedFcbResourceInMRx(
  PMRX_FCB Fcb
);

Paramètres

Fcb

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

Valeur de retour

RxAcquireSharedFcbResourceInMRx 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.
STATUS_CANCELLED	Le RX_CONTEXT associé au FCB a été annulé.

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é.

RxAcquireSharedFcbResourceInMRx attend que la ressource FCB soit gratuite si elle a été acquise exclusivement et ne retourne pas le contrôle tant que la ressource partagée 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 RxAcquireSharedFcbResourceInMRx doit être publiée en appelant RxReleaseFcbResourceInMRx ou RxReleaseFcbResourceForThreadInMRx.