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

Статья
08/07/2023

Функция NdkCreateCompletion (NDK_FN_CREATE_COMPLETION) завершает создание объекта NDK.

Синтаксис

NDK_FN_CREATE_COMPLETION NdkFnCreateCompletion;

void NdkFnCreateCompletion(
  [in, optional] PVOID Context,
  [in]           NTSTATUS Status,
  [in]           NDK_OBJECT_HEADER *pNdkObject
)
{...}

Параметры

[in, optional] Context

Значение контекста, передаваемое поставщику NDK, когда потребитель вызывает функцию создания объекта. Функция создания предоставляет контекст с асинхронным указателем на функцию NdkCreateCompletion (NDK_FN_CREATE_COMPLETION).

[in] Status

Состояние асинхронного завершения для запроса на создание. Коды состояния завершения, которые могут быть возвращены для каждого типа объекта, см. в функциях создания объектов (например, NDK_FN_CREATE_CQ).

[in] pNdkObject

Указатель на заголовок объекта NDK (NDK_OBJECT_HEADER).

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

None

Remarks

Примечание Эта функция реализуется потребителем NDK и передается поставщику NDK.

Объекты NDK создаются с помощью асинхронных функций. Эти асинхронные функции создания объектов принимают указатель функции NDK_FN_CREATE_COMPLETION в качестве входного параметра.

Поставщик NDK может возвращать STATUS_PENDING из асинхронной функции создания объектов. В этом случае поставщик NDK должен вызвать функцию завершения создания, чтобы указать, что создание объекта завершено.

Любой другой код состояния указывает на встроенное завершение. В этом случае поставщик не должен вызывать функцию завершения запроса на создание. Если функция запроса на создание возвращает код состояния NT_STATUS, отличный от STATUS_PENDING, созданный объект должен возвращаться в выходном параметре с функцией create request.

Для запросов на создание, возвращающих STATUS_PENDING и более поздних версий с STATUS_SUCCESS асинхронно, созданный объект должен быть возвращен функцией завершения создания с параметром pNdkObject , а поставщик не должен обращаться к параметру вывода объекта функции запроса на создание.

Требования

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