RxAcquireExclusiveFcbResourceInMRx-Funktion (mrxfcb.h)

Artikel
02/26/2024

RxAcquireExclusiveFcbResourceInMRx ruft die FCB-Ressource für einen Netzwerk-Miniumleitungstreiber im exklusiven Modus ab. Diese Routine wartet, bis die FCB-Ressource frei ist, wenn sie zuvor erworben wurde, und gibt die Kontrolle erst zurück, wenn die exklusive Ressource abgerufen wurde.

Syntax

NTSTATUS RxAcquireExclusiveFcbResourceInMRx(
  PMRX_FCB Fcb
);

Parameter

Fcb

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

Rückgabewert

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

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

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.

RxAcquireExclusiveFcbResourceInMRx wartet, bis die FCB-Ressource frei ist, wenn sie zuvor erworben wurde, und gibt die Steuerung erst zurück, wenn die exklusive Ressource abgerufen wurde. Diese Routine ruft die FCB-Ressource ab, auch wenn die diesem FCB zugeordnete RX_CONTEXT abgebrochen wurde.

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