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

Artículo
02/26/2024

La función NdkCreateListener (NDK_FN_CREATE_LISTENER) crea un objeto de agente de escucha NDK.

Sintaxis

NDK_FN_CREATE_LISTENER NdkFnCreateListener;

NTSTATUS NdkFnCreateListener(
  [in]           NDK_ADAPTER *pNdkAdapter,
  [in]           NDK_FN_CONNECT_EVENT_CALLBACK ConnectEvent,
  [in, optional] PVOID ConnectEventContext,
  [in]           NDK_FN_CREATE_COMPLETION CreateCompletion,
  [in, optional] PVOID RequestContext,
                 NDK_LISTENER **ppNdkListener
)
{...}

Parámetros

[in] pNdkAdapter

Puntero a un objeto de adaptador NDK (NDK_ADAPTER).

[in] ConnectEvent

Puntero a la función NdkConnectEventCallback (NDK_FN_CONNECT_EVENT_CALLBACK) que el proveedor usa para notificar al consumidor cada solicitud de conexión entrante.

[in, optional] ConnectEventContext

Valor de contexto que el proveedor NDK pasa de nuevo a la función NdkConnectEventCallback especificada en el parámetro ConnectEvent .

[in] CreateCompletion

Puntero a una función NdkCreateCompletion (NDK_FN_CREATE_COMPLETION) que completa la creación de un objeto NDK.

[in, optional] RequestContext

Valor de contexto que el proveedor NDK pasa de nuevo a la función NdkCreateCompletion especificada en el parámetro CreateCompletion .

ppNdkListener

Se devuelve un puntero al objeto de escucha NDK creado (NDK_LISTENER) en esta ubicación si la solicitud se realiza correctamente sin devolver STATUS_PENDING. Si NdkCreateListener devuelve STATUS_PENDING se omite este parámetro y se devuelve el objeto creado con la devolución de llamada especificada en el parámetro CreateCompletion .

Valor devuelto

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

Código devuelto	Descripción
STATUS_SUCCESS	El objeto de escucha se creó correctamente y se devolvió con el parámetro *ppNdkListener .
STATUS_PENDING	La operación está pendiente y se completará más adelante. El proveedor llamará a la función especificada en el parámetro CreateCompletion (NDK_FN_CREATE_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.
Otros códigos de estado	Se produjo un error.

Comentarios

La función NdkCreateListener crea un objeto de agente de escucha NDK. Si la función devuelve STATUS_SUCCESS, el objeto creado se devuelve en el parámetro ppNdkListener . Si NdkCreateListener devuelve STATUS_PENDING, la función NdkCreateCompletion (NDK_FN_CREATE_COMPLETION) que se especifica en el parámetro CreateCompletion devuelve el objeto creado.

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