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

  • Статья

Функция NdkInitializeFastRegisterMr (NDK_FN_INITIALIZE_FAST_REGISTER_MR) инициализирует область памяти NDK для быстрой регистрации.

Синтаксис

NDK_FN_INITIALIZE_FAST_REGISTER_MR NdkFnInitializeFastRegisterMr;

NTSTATUS NdkFnInitializeFastRegisterMr(
  [in]           NDK_MR *pNdkMr,
  [in]           ULONG AdapterPageCount,
  [in]           BOOLEAN RemoteAccess,
  [in]           NDK_FN_REQUEST_COMPLETION RequestCompletion,
  [in, optional] PVOID RequestContext
)
{...}

Параметры

[in] pNdkMr

Указатель на объект области памяти NDK (MR) (NDK_MR).

[in] AdapterPageCount

Максимальное количество страниц адаптера для поддержки в этой смешанной реальности, чтобы можно было поддерживать быструю регистрацию рабочих запросов с равным или меньшим количеством страниц адаптера.

[in] RemoteAccess

Значение BOOLEAN, указывающее, нужно ли инициализировать mr для удаленного доступа. Потребитель NDK должен задать для Параметра RemoteAccess значение TRUE, если потребитель запрашивает удаленный доступ с помощью функции NdkFastRegister (NDK_FN_FAST_REGISTER).

[in] RequestCompletion

Указатель на подпрограмму обратного вызова завершения запроса NdkRequestCompletion (NDK_FN_REQUEST_COMPLETION).

[in, optional] RequestContext

Значение контекста, передаваемое параметру Context функции обратного вызова, указанной в параметре RequestCompletion .

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

The
Функция NdkInitializeFastRegisterMr возвращает один из следующих кодов NTSTATUS.

Код возврата Описание
STATUS_SUCCESS
 Инициализация успешно завершена.
STATUS_PENDING
 Операция находится в состоянии ожидания и будет завершена позже. Драйвер вызовет указанную функцию RequestCompletion (NDK_FN_REQUEST_COMPLETION) для завершения ожидающей операции.
STATUS_IMPLEMENTATION_LIMIT
 Сбой запроса, так как адаптер не поддерживает запрошенный AdapterPageCount.
Другие коды состояния
 Произошла ошибка.

Комментарии

NdkInitializeFastRegisterMr инициализирует mr для быстрой регистрации. Объект NDK_MR должен быть создан с параметром FastRegister функции NdkCreateMr (NDK_FN_CREATE_MR), который имеет значение TRUE.

Вы можете выполнять несколько вызовов NdkInitializeFastRegisterMr параллельно или один за другим.

После возврата NdkInitializeFastRegisterMr в паре очередей (QP) можно отправить запрос на работу с быстрой регистрацией.

Требования

Требование Значение
Минимальная версия клиента Не поддерживается, поддерживается в NDIS 6.30 и более поздних версиях.
Минимальная версия сервера Windows Server 2012
Целевая платформа Windows
Header ndkpi.h (включая Ndkpi.h)
IRQL <=DISPATCH_LEVEL

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

Требования к времени существования объектов NDKPI

NDK_FN_CREATE_MR

NDK_FN_FAST_REGISTER

NDK_FN_REQUEST_COMPLETION

NDK_MR