RxAcquireSharedFcbResourceInMRxEx, fonction (mrxfcb.h)

Article
02/07/2025

RxAcquireSharedFcbResourceInMRxEx 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 RxAcquireSharedFcbResourceInMRxEx(
  [in] IN PRX_CONTEXT pRxContext,
       PMRX_FCB       Fcb
);

Paramètres

[in] pRxContext

Pointeur vers la RX_CONTEXT. Ce paramètre fournit le contexte de l’opération pour un traitement spécial par le suivi RDBSS interne si cette fonctionnalité est activée.

Fcb

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

Valeur de retour

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

RxAcquireSharedFcbResourceInMRxEx 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 RxAcquireSharedFcbResourceInMRxEx doit être publiée en appelant RxReleaseFcbResourceInMRx ou RxReleaseFcbResourceForThreadInMRx.

Exigences

Exigence	Valeur
client minimum pris en charge	La routine RxAcquireSharedFcbResourceInMRxEx est disponible uniquement sur Windows Server 2003 Service Pack 1 et versions ultérieures.
plateforme cible	Bureau
d’en-tête	mrxfcb.h (inclure Mrxfcb.h)
IRQL	<= APC_LEVEL

Voir aussi

RxAcquireExclusiveFcbResourceInMRx

RxAcquireSharedFcbResourceInMRx

RxReleaseFcbResourceForThreadInMRx

RxReleaseFcbResourceInMRx

Partager via