RxAcquireSharedFcbResourceInMRxEx-Funktion (mrxfcb.h)

Artikel
03/01/2024

RxAcquireSharedFcbResourceInMRxEx ruft die FCB-Ressource für einen Netzwerk-Miniumleitungstreiber im freigegebenen Modus ab. Diese Routine wartet, bis die FCB-Ressource kostenlos ist, wenn sie zuvor exklusiv erworben wurde, und gibt die Kontrolle erst zurück, wenn die freigegebene Ressource abgerufen wurde.

Syntax

NTSTATUS RxAcquireSharedFcbResourceInMRxEx(
  [in] IN PRX_CONTEXT pRxContext,
       PMRX_FCB       Fcb
);

Parameter

[in] pRxContext

Ein Zeiger auf die RX_CONTEXT. Dieser Parameter stellt den Kontext des Vorgangs für eine spezielle Behandlung durch interne RDBSS-Nachverfolgung bereit, wenn dieses Feature aktiviert ist.

Fcb

Ein Zeiger auf den FCB. Dieser Parameter ist erforderlich und darf nicht NULL sein.

Rückgabewert

RxAcquireSharedFcbResourceInMRxEx gibt bei Erfolg STATUS_SUCCESS oder einen der folgenden Fehlercodes zurück:

Rückgabecode	Beschreibung
STATUS_LOCK_NOT_GRANTED	Die FCB-Ressource wurde nicht erworben.
STATUS_CANCELLED	Die dem FCB zugeordnete RX_CONTEXT wurde abgebrochen.

Hinweise

Die Synchronisierungsressourcen, die für einen Netzwerk-Miniumleitungstreiber von Interesse sind, sind in erster Linie dem FCB zugeordnet. Es gibt eine E/A-Ressource für Paging und eine reguläre Ressource. Die E/A-Pagingressource wird intern von RDBSS verwaltet. Die einzige Ressource, auf die ein Netzwerk-Miniumleitungstreiber zugreifen kann, ist die reguläre Ressource, auf die je nach gewünschtem Modus über RxAcquireExclusiveFcbResourceInMRx, RxAcquireExbResourceInMRxEx oder RxAcquireSharedFcbResourceInMRx zugegriffen werden soll.

RxAcquireSharedFcbResourceInMRxEx wartet, bis die FCB-Ressource kostenlos ist, wenn sie zuvor exklusiv erworben wurde, und gibt die Kontrolle erst zurück, wenn die freigegebene Ressource abgerufen wurde. Diese Routine ruft die FCB-Ressource ab, auch wenn die diesem FCB zugeordnete RX_CONTEXT abgebrochen wurde.

Eine MIT RxAcquireSharedFcbResourceInMRxEx erworbene FCB-Ressource sollte durch Aufrufen von RxReleaseFcbResourceInMRx oder RxReleaseFcbResourceForThreadInMRx freigegeben werden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Die RxAcquireSharedFcbResourceInMRxEx-Routine ist nur unter Windows Server 2003 Service Pack 1 und höher verfügbar.
Zielplattform	Desktop
Kopfzeile	mrxfcb.h (einschließlich Mrxfcb.h)
IRQL	<= APC_LEVEL

Weitere Informationen

RxAcquireExclusiveFcbResourceInMRx

RxAcquireSharedFcbResourceInMRx

RxReleaseFcbResourceForThreadInMRx

RxReleaseFcbResourceInMRx

Freigeben über