Compartir a través de

NDK_FN_LISTEN función de devolución de llamada (ndkpi.h)

  • Artículo

La función NdkListen (NDK_FN_LISTEN) coloca un objeto de agente de escucha NDK en modo de escucha.

Sintaxis

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
)
{...}

Parámetros

[in] pNdkListener

Puntero a un objeto de agente de escucha NDK (NDK_LISTENER).

pAddress

Una dirección local en la que se va a escuchar. Para AF_INET o AF_INET6 pAddress contiene la dirección IP local y el puerto ND local.

[in] AddressLength

Tamaño, en bytes, de datos de direcciones locales en el parámetro pAddress pAddress.

[in] RequestCompletion

Puntero a una rutina de devolución de llamada de finalización de solicitudes NdkRequestCompletion (NDK_FN_REQUEST_COMPLETION).

[in, optional] RequestContext

Valor de contexto que se va a pasar al parámetro context de de la función de devolución de llamada especificada en el parámetro RequestCompletion de.

Valor devuelto

La función NdkListen devuelve uno de los siguientes códigos NTSTATUS.

Código devuelto Descripción
STATUS_SUCCESS
 La solicitud de escucha se realizó correctamente.
STATUS_PENDING
 La operación está pendiente y se completará más adelante. El controlador llamará a la función RequestCompletion especificada (NDK_FN_REQUEST_COMPLETION) para completar la operación pendiente.
STATUS_INSUFFICIENT_RESOURCES
 Error en la solicitud debido a recursos insuficientes.
Importante La solicitud puede producir un error en línea, así como de forma asincrónica con este código de estado.
 
STATUS_SHARING_VIOLATION
 Error en la solicitud porque la dirección local especificada ya está en uso.
Importante La solicitud puede producir un error en línea, así como de forma asincrónica con este código de estado.
 
STATUS_INVALID_ADDRESS
 Error en la solicitud porque la dirección local especificada no es una dirección válida para el adaptador.
Importante La solicitud puede producir un error en línea, así como de forma asincrónica con este código de estado.
 
STATUS_TOO_MANY_ADDRESSES
 Error en la solicitud porque el consumidor especificó un número de puerto local de cero y el proveedor de Network Direct no pudo asignar un puerto desde el espacio de puerto efímero (puertos 49152-65535).
otros códigos de estado
 Error.

Observaciones

NdkListen coloca un objeto de escucha en modo de escucha en la dirección local especificada.

Requisitos

Requisito Valor
cliente mínimo admitido Ninguna compatible, compatible con NDIS 6.30 y versiones posteriores.
servidor mínimo admitido Windows Server 2012
de la plataforma de destino de Windows
encabezado de ndkpi.h (incluya Ndkpi.h)
irQL <=DISPATCH_LEVEL

Consulte también

requisitos de duración de objetos NDKPI

NDK_FN_REQUEST_COMPLETION

NDK_LISTENER