функция обратного вызова PMRX_IS_LOCK_REALIZABLE (mrx.h)

Статья
02/26/2024

Подпрограмма MRxIsLockRealizable вызывается RDBSS , чтобы запросить, чтобы мини-перенаправитель сети указал, поддерживается ли определенная блокировка диапазона байтов в этой NET_ROOT структуре.

Синтаксис

PMRX_IS_LOCK_REALIZABLE PmrxIsLockRealizable;

NTSTATUS PmrxIsLockRealizable(
  IN OUT PMRX_FCB Fcb,
  IN PLARGE_INTEGER ByteOffset,
  IN PLARGE_INTEGER Length,
  IN ULONG LowIoLockFlags
)
{...}

Параметры

Fcb

[вход, выход] Указатель на структуру FCB.

ByteOffset

[in] Значение , указывающее смещение байтов для блокировки диапазона байтов.

Length

[in] Значение типа , указывающее длину блокировки диапазона байтов.

LowIoLockFlags

[in] Значение с битовой маской, указывающее флаги блокировки ввода-вывода.

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

MRxIsLockRealizable возвращает STATUS_SUCCESS при успешном выполнении или соответствующее значение NTSTATUS, например следующее:

Код возврата	Описание
STATUS_NOT_SUPPORTED	Запрошенная блокировка диапазона байтов не поддерживается. Мини-перенаправитель сети вернет это значение для запроса блокировки, который не поддерживается, даже если поддерживаются другие типы блокировок диапазона байтов. Неподдерживаемые блокировки могут включать 64-разрядные блокировки (элемент ByteOffset-HighPart> ненулевой), блокировки нулевой длины (параметр Length равен нулю) или общие блокировки (LOWIO_LOCKSFLAG_EXCLUSIVELOCK бит параметра LowIoLockFlags не задан).

Код возврата

Описание

STATUS_NOT_SUPPORTED

Запрошенная блокировка диапазона байтов не поддерживается. Мини-перенаправитель сети вернет это значение для запроса блокировки, который не поддерживается, даже если поддерживаются другие типы блокировок диапазона байтов. Неподдерживаемые блокировки могут включать 64-разрядные блокировки (элемент ByteOffset-HighPart> ненулевой), блокировки нулевой длины (параметр Length равен нулю) или общие блокировки (LOWIO_LOCKSFLAG_EXCLUSIVELOCK бит параметра LowIoLockFlags не задан).

MRxIsLockRealizable определяет, поддерживается ли определенная запрошенная блокировка диапазона байтов для этой структуры NET_ROOT. Сетевой мини-перенаправитель может поддерживать определенные блокировки диапазона байтов, а не поддерживать другие. Например, сетевой мини-перенаправитель может поддерживать только 32-разрядные блокировки диапазона байтов или монопольные блокировки.

MRxIsLockRealizable вызывается в ответ на получение IRP с дополнительной функцией IRP_MN_LOCK.