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

Статья
08/07/2023

Функция NdkListen (NDK_FN_LISTEN) переводит объект прослушивателя NDK в режим прослушивания.

Синтаксис

NDK_FN_LISTEN NdkFnListen;

NTSTATUS NdkFnListen(
  [in]           NDK_LISTENER *pNdkListener,
                 const PSOCKADDR pAddress,
  [in]           ULONG AddressLength,
  [in]           NDK_FN_REQUEST_COMPLETION RequestCompletion,
  [in, optional] PVOID RequestContext
)
{...}

Параметры

[in] pNdkListener

Указатель на объект прослушивателя NDK (NDK_LISTENER).

pAddress

Локальный адрес для прослушивания. Для AF_INET или AF_INET6 pAddress содержит локальный IP-адрес и локальный порт ND.

[in] AddressLength

Размер данных локального адреса в байтах в параметре pAddress .

[in] RequestCompletion

Указатель на подпрограмму обратного вызова завершения запроса NdkRequestCompletion (NDK_FN_REQUEST_COMPLETION).

[in, optional] RequestContext

Значение контекста, передаваемое параметру Context функции обратного вызова, указанной в параметре RequestCompletion .

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

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

Код возврата	Описание
STATUS_SUCCESS	Запрос прослушивания выполнен успешно.
STATUS_PENDING	Операция находится в состоянии ожидания и будет завершена позже. Драйвер вызовет указанную функцию RequestCompletion (NDK_FN_REQUEST_COMPLETION) для завершения ожидающей операции.
STATUS_INSUFFICIENT_RESOURCES	Запрос завершился сбоем из-за нехватки ресурсов. Важно Запрос может завершиться как встроенным, так и асинхронным с этим кодом состояния.
STATUS_SHARING_VIOLATION	Сбой запроса, так как указанный локальный адрес уже используется. Важно Запрос может завершиться как встроенным, так и асинхронным с этим кодом состояния.
STATUS_INVALID_ADDRESS	Сбой запроса, так как указанный локальный адрес не является допустимым адресом адаптера. Важно Запрос может завершиться как встроенным, так и асинхронным с этим кодом состояния.
STATUS_TOO_MANY_ADDRESSES	Сбой запроса, так как потребитель указал номер локального порта, равный нулю, а поставщику Network Direct не удалось выделить порт из пространства временных портов (порты 49152–65535).
Другие коды состояния	Произошла ошибка.

Требования

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

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

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

NDK_FN_REQUEST_COMPLETION

NDK_LISTENER