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

Статья
08/07/2023

Функция NdkCreateListener (NDK_FN_CREATE_LISTENER) создает объект прослушивателя NDK.

Синтаксис

NDK_FN_CREATE_LISTENER NdkFnCreateListener;

NTSTATUS NdkFnCreateListener(
  [in]           NDK_ADAPTER *pNdkAdapter,
  [in]           NDK_FN_CONNECT_EVENT_CALLBACK ConnectEvent,
  [in, optional] PVOID ConnectEventContext,
  [in]           NDK_FN_CREATE_COMPLETION CreateCompletion,
  [in, optional] PVOID RequestContext,
                 NDK_LISTENER **ppNdkListener
)
{...}

Параметры

[in] pNdkAdapter

Указатель на объект адаптера NDK (NDK_ADAPTER).

[in] ConnectEvent

Указатель на функцию NdkConnectEventCallback (NDK_FN_CONNECT_EVENT_CALLBACK), которую поставщик использует для уведомления потребителя о каждом входящем запросе на подключение.

[in, optional] ConnectEventContext

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

[in] CreateCompletion

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

[in, optional] RequestContext

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

ppNdkListener

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

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

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

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

Функция NdkCreateListener создает объект прослушивателя NDK. Если функция возвращает STATUS_SUCCESS, созданный объект возвращается в параметре ppNdkListener . Если NdkCreateListener возвращает STATUS_PENDING, созданный объект возвращается функцией NdkCreateCompletion (NDK_FN_CREATE_COMPLETION), указанной в параметре CreateCompletion .

Требования

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