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

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

  • Статья

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

Синтаксис

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 (NDK_PD).

[in] FastRegister

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

[in] CreateCompletion

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

[in, optional] RequestContext

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

ppNdkMr

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

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

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

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

Комментарии

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

Требования

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

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

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

NDK_FN_CREATE_COMPLETION

NDK_MR

NDK_PD