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

Artículo
02/07/2025

La función NdkAcceptEx (NDK_FN_ACCEPT_EX) acepta una solicitud de conexión entrante a través de un objeto de escucha.

Sintaxis

NDK_FN_ACCEPT_EX NdkFnAcceptEx;

NTSTATUS NdkFnAcceptEx(
  [in]                                      NDK_CONNECTOR *pNdkConnector,
  [in]                                      NDK_QP *pNdkQp,
  [in]                                      ULONG InboundReadLimit,
  [in]                                      ULONG OutboundReadLimit,
  [_In_reads_bytes_opt_(PrivateDataLength)] const PVOID pPrivateData,
  [in]                                      ULONG PrivateDataLength,
  [in, optional]                            NDK_FN_DISCONNECT_EVENT_CALLBACK_EX DisconnectEvent,
  [in, optional]                            PVOID DisconnectEventContext,
  [in]                                      NDK_FN_REQUEST_COMPLETION RequestCompletion,
  [in, optional]                            PVOID RequestContext
)
{...}

Parámetros

[in] pNdkConnector

Puntero a un objeto de conector NDK (NDK_CONNECTOR).

[in] pNdkQp

Puntero a un objeto de par de cola de NDK (QP) (NDK_QP) que se va a asociar a la conexión.

[in] InboundReadLimit

El número máximo proporcionado por el consumidor de las operaciones de lectura en curso entrantes para permitir en el QP. Si el proveedor subyacente tiene un valor inferior MaxInboundReadLimit en la estructura de NDK_ADAPTER_INFO, el proveedor limitará el valor proporcionado por el consumidor al máximo del proveedor. Si el elemento del mismo nivel tiene un OutboundReadLimit inferior, el proveedor usará ese valor como InboundReadLimit efectivo. El consumidor puede recuperar el inboundRead Limit efectivo llamando a la función NdkGetConnectionData (NDK_FN_GET_CONNECTION_DATA).

[in] OutboundReadLimit

Número máximo proporcionado por el consumidor de operaciones de lectura en curso salientes para permitir en el QP. Si el proveedor subyacente tiene un valor inferior MaxOutboundReadLimit en la estructura NDK_ADAPTER_INFO, el proveedor limitará el valor proporcionado por el consumidor al máximo del proveedor. Si el elemento del mismo nivel tiene un inboundReadLimit inferior, el proveedor usará ese valor como OutboundReadLimit efectivo. El consumidor puede recuperar el OutboundReadLimit efectivo llamando a la función NdkGetConnectionData (NDK_FN_GET_CONNECTION_DATA).

[_In_reads_bytes_opt_(PrivateDataLength)] pPrivateData

Datos privados que se devuelven con la solicitud de aceptación.

[in] PrivateDataLength

Longitud, en bytes, de los datos privados que se proporcionan en el parámetro pPrivateData.

[in, optional] DisconnectEvent

Un punto de entrada para una función de devolución de llamada de notificación de desconexión opcional NdkDisconnectEventCallbackEx NDK_FN_DISCONNECT_EVENT_CALLBACK_EX. El proveedor llama a esta función de devolución de llamada cuando el elemento del mismo nivel se desconecta.

[in, optional] DisconnectEventContext

Valor de contexto que se va a pasar al parámetro DisconnectEventContext de la función de devolución de llamada que se especifica en el parámetro DisconnectEvent de.

[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 NDK_FN_ACCEPT_EX devuelve uno de los siguientes códigos NTSTATUS.

Código devuelto	Descripción
STATUS_SUCCESS	La operación se completó 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_CONNECTION_ABORTED	El emparejamiento de conexión abandonó el establecimiento de conexión pendiente.
STATUS_IO_TIMEOUT	El mismo nivel no llamó a la función CompleteConnect (NDK_FN_COMPLETE_CONNECT_EX) para completar la solicitud de conexión pendiente.
otros códigos de estado	Error.

Observaciones

El consumidor de NDK llama a NdkAcceptEx para aceptar una solicitud de conexión entrante a través de un objeto de escucha.

La función NdkCreateListener (NDK_FN_CREATE_LISTENER) crea un objeto de escucha NDK y proporciona una función NdkConnectEventCallback (NDK_FN_CONNECT_EVENT_CALLBACK).

El proveedor de NDK usa la función NdkConnectEventCallback para notificar al consumidor cada solicitud de conexión entrante.

Requisitos

Requisito	Valor
cliente mínimo admitido	Se admite en NDKPI 2.1 y versiones posteriores.
servidor mínimo admitido	Windows Server 2022
de la plataforma de destino de	Windows
encabezado de	ndkpi.h (incluya Ndkpi.h)
irQL	<=DISPATCH_LEVEL