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


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

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

См. также

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

NDK_FN_CREATE_CONNECTOR

NDK_FN_CREATE_CQ

NDK_FN_CREATE_LISTENER

NDK_FN_CREATE_MR

NDK_FN_CREATE_MW

NDK_FN_CREATE_PD

NDK_FN_CREATE_QP

NDK_FN_CREATE_QP_WITH_SRQ

NDK_FN_CREATE_SHARED_ENDPOINT

NDK_FN_CREATE_SRQ

NDK_OBJECT_HEADER