RxAcquireSharedFcbResourceInMRxEx-Funktion (mrxfcb.h)

Artikel
02/07/2025

RxAcquireSharedFcbResourceInMRxEx übernimmt die FCB-Ressource für einen Netzwerk-Miniumleitungstreiber im gemeinsam genutzten Modus. Diese Routine wartet darauf, dass die FCB-Ressource frei ist, wenn sie zuvor exklusiv erworben wurde und erst dann die Kontrolle zurückgibt, wenn die freigegebene Ressource erworben 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 dar, wenn dieses Feature aktiviert ist.

Fcb

Ein Zeiger auf den FCB. Dieser Parameter ist erforderlich und kann nicht NULL-werden.

Rückgabewert

RxAcquireSharedFcbResourceInMRxEx gibt STATUS_SUCCESS bei Erfolg oder einer der folgenden Fehlercodes für Fehler zurück:

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

Bemerkungen

Die Synchronisierungsressourcen, die für einen Netzwerk-Miniumleitungstreiber von Interesse sind, sind in erster Linie mit dem FCB verbunden. Es gibt eine Auslagerungs-E/A-Ressource und eine normale Ressource. Die Auslagerungs-E/A-Ressource wird intern von RDBSS verwaltet. Die einzige Ressource, auf die ein Netzwerk-Miniumleitungstreiber zugreifen kann, ist die normale Ressource, auf die über RxAcquireExclusiveFcbResourceInMRx, RxAcquireExclusiveFcbResourceInMRxExoder RxAcquireSharedFcbResourceInMRxzugegriffen werden soll, je nach dem gewünschten erworbenen Modus.

RxAcquireSharedFcbResourceInMRxEx warten, bis die FCB-Ressource frei ist, wenn sie zuvor exklusiv erworben wurde und erst dann die Kontrolle zurückgibt, wenn die freigegebene Ressource erworben wurde. Diese Routine erwirbt die FCB-Ressource, auch wenn die RX_CONTEXT, die diesem FCB zugeordnet ist, abgebrochen wurde.

Eine mit RxAcquireSharedFcbResourceInMRxEx erworbene FCB-Ressource sollte durch Aufrufen RxReleaseFcbResourceInMRx oder RxReleaseFcbResourceForThreadInMRxfreigegeben werden.

Anforderungen

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

Siehe auch

RxAcquireExclusiveFcbResourceInMRx

RxAcquireSharedFcbResourceInMRx

RxReleaseFcbResourceForThreadInMRx

RxReleaseFcbResourceInMRx

Freigeben über