RxAcquireSharedFcbResourceInMRx-Funktion (mrxfcb.h)

Artikel
02/07/2025

RxAcquireSharedFcbResourceInMRx ü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 RxAcquireSharedFcbResourceInMRx(
  PMRX_FCB Fcb
);

Parameter

Fcb

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

Rückgabewert

RxAcquireSharedFcbResourceInMRx 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.

RxAcquireSharedFcbResourceInMRx warten, bis die FCB-Ressource frei ist, wenn sie zuvor ausschließlich 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 RxAcquireSharedFcbResourceInMRx erworbene FCB-Ressource sollte durch Aufrufen RxReleaseFcbResourceInMRx oder RxReleaseFcbResourceForThreadInMRxfreigegeben werden.