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

Статья
02/07/2025

Функция 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).

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

Никакой

Замечания

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

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

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

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

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

Требования

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