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

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

  • Статья

Функция 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).
Другие коды состояния
 Произошла ошибка.

Комментарии

NdkListen переводит объект прослушивателя в режим прослушивания по указанному локальному адресу.

Требования

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

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

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

NDK_FN_REQUEST_COMPLETION

NDK_LISTENER