Fonction RxAcquireSharedFcbResourceInMRxEx (mrxfcb.h)

Article
02/29/2024

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 le 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 le 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 avoir la valeur NULL.

Valeur retournée

RxAcquireSharedFcbResourceInMRxEx 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.
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 standard qui doit être accessible à l’aide de RxAcquireExclusiveFcbResourceInMRx, RxAcquireExclusiveFcbResourceInMRxEx ou RxAcquireSharedFcbResourceInMRx, selon le 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 libérée en appelant RxReleaseFcbResourceInMRx ou RxReleaseFcbResourceForThreadInMRx.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	La routine RxAcquireSharedFcbResourceInMRxEx est disponible uniquement sur Windows Server 2003 Service Pack 1 et versions ultérieures.
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	mrxfcb.h (inclure Mrxfcb.h)
IRQL	<= APC_LEVEL

Voir aussi

RxAcquireExclusiveFcbResourceInMRx

RxAcquireSharedFcbResourceInMRx

RxReleaseFcbResourceForThreadInMRx

RxReleaseFcbResourceInMRx

Partager via