Функция RxAcquireSharedFcbResourceInMRxEx (mrxfcb.h)

Статья
08/07/2023

RxAcquireSharedFcbResourceInMRxEx получает ресурс FCB для драйвера сетевого мини-перенаправления в общем режиме. Эта подпрограмма будет ожидать освобождения ресурса FCB, если он ранее был приобретен исключительно, и не возвращает управление, пока общий ресурс не будет приобретен.

Синтаксис

NTSTATUS RxAcquireSharedFcbResourceInMRxEx(
  [in] IN PRX_CONTEXT pRxContext,
       PMRX_FCB       Fcb
);

Параметры

[in] pRxContext

Указатель на RX_CONTEXT. Этот параметр предоставляет контекст операции для специальной обработки внутренним отслеживанием RDBSS, если эта функция включена.

Fcb

Указатель на FCB. Этот параметр является обязательным и не может иметь значение NULL.

Возвращаемое значение

RxAcquireSharedFcbResourceInMRxEx возвращает STATUS_SUCCESS при успешном выполнении или один из следующих кодов ошибок при сбое:

Код возврата	Описание
STATUS_LOCK_NOT_GRANTED	Ресурс FCB не был приобретен.
STATUS_CANCELLED	Отменена RX_CONTEXT, связанная с FCB.

Ресурсы синхронизации, представляющие интерес для драйвера сетевого мини-перенаправления, в основном связаны с FCB. Существует ресурс ввода-вывода подкачки и обычный ресурс. Ресурс ввода-вывода подкачки управляется внутренней службой RDBSS. Единственный ресурс, доступный драйверу сетевого мини-перенаправления, — это обычный ресурс, к которому следует обращаться с помощью RxAcquireExclusiveFcbResourceInMRx, RxAcquireExclusiveFcbResourceInMRxEx или RxAcquireSharedFcbResourceInMRx в зависимости от требуемого режима получения.

RxAcquireSharedFcbResourceInMRxEx будет ожидать освобождения ресурса FCB, если он ранее был приобретен исключительно, и не возвращает управление, пока общий ресурс не будет приобретен. Эта подпрограмма получает ресурс FCB, даже если RX_CONTEXT, связанный с этим FCB, был отменен.

Ресурс FCB, полученный с помощью RxAcquireSharedFcbResourceInMRxEx , должен быть освобожден путем вызова RxReleaseFcbResourceInMRx или RxReleaseFcbResourceForThreadInMRx.

Требования

Требование	Значение
Минимальная версия клиента	Подпрограмма RxAcquireSharedFcbResourceInMRxEx доступна только в Windows Server 2003 с пакетом обновления 1 (SP1) и более поздних версий.
Целевая платформа	Персональный компьютер
Верхняя часть	mrxfcb.h (включая Mrxfcb.h)
IRQL	<= APC_LEVEL

См. также раздел

RxAcquireExclusiveFcbResourceInMRx

RxAcquireSharedFcbResourceInMRx

RxReleaseFcbResourceForThreadInMRx

RxReleaseFcbResourceInMRx

Share via