Función NdisCmDispatchIncomingCloseCall (ndis.h)

Artículo
02/07/2025

NdisCmDispatchIncomingCloseCall indica a un cliente que desconecte una llamada activa o ofrecida, normalmente porque el administrador de llamadas ha recibido una solicitud de la red para cerrar la conexión.

Sintaxis

void NdisCmDispatchIncomingCloseCall(
  [in]           NDIS_STATUS CloseStatus,
  [in]           NDIS_HANDLE NdisVcHandle,
  [in, optional] PVOID       Buffer,
  [in]           UINT        Size
);

Parámetros

[in] CloseStatus

Especifica un NDIS_STATUS_XXX determinado por CM, que indica el motivo de la solicitud de desconexión. Durante las operaciones de red normales, un administrador de llamadas pasa NDIS_STATUS_SUCCESS para indicar que ha recibido una solicitud, iniciada por la entidad remota, para cerrar una llamada activa.

[in] NdisVcHandle

Especifica el identificador del VC de la llamada que se está desconectando. Este identificador lo proporcionó NDIS cuando el VC se creó originalmente, ya sea por el administrador de llamadas o el cliente, con NdisCoCreateVc.

[in, optional] Buffer

Puntero a un búfer residente asignado por el autor de la llamada que contiene datos de desconexión específicos del protocolo adicionales, si los hay. Dependiendo del medio subyacente, este puntero puede ser NULL

[in] Size

Especifica el tamaño en bytes del búfer, cero si Búfer es NULL.

Valor devuelto

Ninguno

Observaciones

En el curso de las operaciones de red normales, una instancia de CM independiente llama a NdisCmDispatchIncomingCloseCall con el CloseStatus establecido en NDIS_STATUS_SUCCESS porque el cliente correspondiente del nodo remoto ha llamado a NdisClCloseCall.

Sin embargo, un administrador de llamadas también puede llamar a NdisCmDispatchIncomingCloseCall si se produce alguna de las siguientes acciones:

El administrador de llamadas ha notificado a un cliente de una oferta de llamada entrante. Cuándo está el CM se llama a la función protocolCmIncomingCallComplete con la aceptación del cliente, valida los parámetros de llamada de entrada, que ese cliente ha modificado. ProtocolCmIncomingCallComplete determina que el cliente propone parámetros de llamada no compatibles para la conexión, por lo que llama a NdisCmDispatchIncomingCloseCall.
Las condiciones de red anómalas obligan al administrador de llamadas a anular las llamadas activas. Por ejemplo, si el administrador de llamadas recibe una notificación cuando un vínculo en la conexión entre este cliente y la entidad remota a la conexión deja de funcionar, el CM llamaría a NdisCmDispatchIncomingCloseCall para evitar que el cliente intente (o espere) transferencias de datos adicionales en dicha conexión interrumpida.

Después de anular cualquier llamada, el creador original del VC es responsable de llamar a NdisCoDeleteVc después de liberar los recursos adicionales que había asociado con el VC.

Una llamada a NdisCmDispatchIncomingCloseCall hace que NDIS llame al cliente. función ProtocolClIncomingCloseCall.

Solo los administradores de llamadas independientes, que se registran con NDIS como controladores de protocolo, pueden llamar a NdisCmDispatchIncomingCloseCall. Controladores de miniport orientados a la conexión que proporcionan una llamada de soporte técnico de administración de llamadas NdisMCmDispatchIncomingCall en su lugar.

Requisitos

Requisito	Valor
cliente mínimo admitido	Compatible con los controladores NDIS 6.0 y NDIS 5.1 (consulte NdisCmDispatchIncomingCloseCall (NDIS 5.1)) en Windows Vista. Compatible con los controladores NDIS 5.1 (consulte NdisCmDispatchIncomingCloseCall (NDIS 5.1)) en Windows XP.
de la plataforma de destino de	Escritorio
encabezado de	ndis.h (incluya Ndis.h)
biblioteca de	Ndis.lib
irQL	<= DISPATCH_LEVEL
reglas de cumplimiento de DDI	Irql_CallManager_Function(ndis)