RxAcquireSharedFcbResourceInMRx-Funktion (mrxfcb.h)

Artikel
02/26/2024

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

Parameter

Fcb

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

Rückgabewert

RxAcquireSharedFcbResourceInMRx gibt bei Erfolg STATUS_SUCCESS oder einen der folgenden Fehlercodes bei 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 abgesagt.

Hinweise

Die Synchronisierungsressourcen, die für einen Netzwerk-Miniumleitungstreiber von Interesse sind, sind in erster Linie dem FCB zugeordnet. Es gibt eine auslagernde E/A-Ressource und eine reguläre Ressource. Die Auslagerungs-E/A-Ressource 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 abgerufenen Modus mithilfe von RxAcquireExclusiveFcbResourceInMRxx oder RxAcquireSharedFcbResourceInMRxx über RxAcquireFcbResourceInMRx zugegriffen werden sollte.

RxAcquireSharedFcbResourceInMRx 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 RxAcquireSharedFcbResourceInMRx erworbene FCB-Ressource sollte durch Aufrufen von RxReleaseFcbResourceInMRx oder RxReleaseFcbResourceForThreadInMRx freigegeben werden.