Fonction RxAcquireSharedFcbResourceInMRxEx (mrxfcb.h)
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 |
|---|---|
|
La ressource FCB n’a pas été acquise. |
|
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