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

Статья
02/07/2025

Функция NdkCreateMr (NDK_FN_CREATE_MR) создает объект области памяти NDK (MR).

Синтаксис

NDK_FN_CREATE_MR NdkFnCreateMr;

NTSTATUS NdkFnCreateMr(
  [in]           NDK_PD *pNdkPd,
  [in]           BOOLEAN FastRegister,
  [in]           NDK_FN_CREATE_COMPLETION CreateCompletion,
  [in, optional] PVOID RequestContext,
                 NDK_MR **ppNdkMr
)
{...}

Параметры

[in] pNdkPd

Указатель на объект защиты NDK (PD) (NDK_PD).

[in] FastRegister

Если значение TRUE, mr предназначен только для быстрого регистрации. В противном случае mr предназначен только для обычной регистрации.

[in] CreateCompletion

Указатель на функцию NdkCreateCompletion (NDK_FN_CREATE_COMPLETION), которая завершает создание объекта NDK.

[in, optional] RequestContext

Значение контекста, которое поставщик NDK передает обратно в функцию NdkCreateCompletion, указанную в параметре CreateCompletion.

ppNdkMr

Указатель на созданный объект MR (NDK_MR) возвращается в этом расположении, если запрос завершается успешно, не возвращая STATUS_PENDING. Если NdkCreateMr возвращает STATUS_PENDING, этот параметр игнорируется, а созданный объект возвращается с обратным вызовом, указанным в параметре CreateCompletion.

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

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

Возвращаемый код	Описание
STATUS_SUCCESS	Объект MR был успешно создан и возвращен с помощью параметра *ppNdkMr.
STATUS_PENDING	Операция ожидается и будет завершена позже. Поставщик вызовет функцию, указанную в параметре createCompletion (NDK_FN_CREATE_COMPLETION) для завершения ожидающей операции.
STATUS_INSUFFICIENT_RESOURCES	Сбой запроса из-за нехватки ресурсов. Важные запрос может завершиться сбоем, а также асинхронно с этим кодом состояния.
Другие коды состояния	Произошла ошибка.

Замечания

Функция NdkCreateMr создает объект области памяти NDK (MR), который можно использовать для регистрации памяти и быстрых запросов на регистрацию памяти. Если функция возвращает STATUS_SUCCESS, созданный объект возвращается в параметре ppNdkMr. Если NdkCreateMr возвращает STATUS_PENDING, созданный объект возвращается функцией NdkCreateCompletion (NDK_FN_CREATE_COMPLETION), указанной в параметре createCompletion .

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Не поддерживается, поддерживается в NDIS 6.30 и более поздних версиях.
минимальный поддерживаемый сервер	Windows Server 2012
целевая платформа	Виндоус
заголовка	ndkpi.h (include Ndkpi.h)
IRQL	<=DISPATCH_LEVEL

См. также

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

NDK_FN_CREATE_COMPLETION

NDK_MR

NDK_PD

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