RxAcquireExclusiveFcbResourceInMRx-Funktion (mrxfcb.h)

Artikel
02/07/2025

RxAcquireExclusiveFcbResourceInMRx übernimmt die FCB-Ressource für einen Netzwerk-Miniumleitungstreiber im exklusiven Modus. Diese Routine wartet darauf, dass die FCB-Ressource frei ist, wenn sie zuvor erworben wurde und die Kontrolle erst zurückgibt, wenn die exklusive Ressource erworben wurde.

Syntax

NTSTATUS RxAcquireExclusiveFcbResourceInMRx(
  PMRX_FCB Fcb
);

Parameter

Fcb

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

Rückgabewert

RxAcquireExclusiveFcbResourceInMRx gibt STATUS_SUCCESS bei Erfolg oder einer der folgenden Fehlercodes bei Einem Fehler zurück:

Rückgabecode	Beschreibung
STATUS_LOCK_NOT_GRANTED	Die FCB-Ressource wurde nicht erworben.

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.

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

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