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 escucha NDK (NDK_LISTENER).

pAddress

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 dirección local en el parámetro 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 la función de devolución de llamada especificada en el parámetro RequestCompletion .

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 (NDK_FN_REQUEST_COMPLETION) especificada 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 puertos efímeros (puertos 49152-65535).
Otros códigos de estado
 Se produjo un error.

Comentarios

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

Requisitos

Requisito Value
Cliente mínimo compatible Ninguno compatible, compatible con NDIS 6.30 y versiones posteriores.
Servidor mínimo compatible Windows Server 2012
Plataforma de destino Windows
Encabezado ndkpi.h (incluya Ndkpi.h)
IRQL <=DISPATCH_LEVEL

Consulte también

Requisitos de duración del objeto NDKPI

NDK_FN_REQUEST_COMPLETION

NDK_LISTENER