Partager via

Fonction RxAcquireSharedFcbResourceInMRxEx (mrxfcb.h)

  • Article

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