Поделиться через

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

  • Статья

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