Macro NdisMCmCloseCallComplete (ndis.h)

Artículo
03/08/2023

NdisMCmCloseCallComplete devuelve el estado final de la solicitud de un cliente, para la que el controlador MCM devolvió previamente NDIS_STATUS_PENDING, para anular una llamada.

Sintaxis

void NdisMCmCloseCallComplete(
   _S_,
   _VH_,
   _PH_
);

Parámetros

_S_

Especifica el estado final de la solicitud del cliente de que el controlador MCM cierre la conexión, ya sea NDIS_STATUS_SUCCESS o cualquier NDIS_STATUS_XXX determinado por el autor de la llamada, excepto NDIS_STATUS_PENDING.

_VH_

Especifica el identificador para la credencial verificable de la llamada. Este identificador lo proporcionó NDIS cuando se creó originalmente la credencial verificable, ya sea por el controlador MCM con NdisMCmCreateVc o como parámetro de entrada para su función ProtocolCoCreateVc .

_PH_

Especifica NULL si NdisVcHandle representa un VC de punto a punto o el identificador de la última parte restante en una conexión multipunto, que el controlador MCM obtuvo de su estado por entidad designado por CallMgrPartyContext pasado como parámetro de entrada a su Función ProtocolCmCloseCall .

Valor devuelto

None

Observaciones

Si la función ProtocolCmCloseCall de un controlador MCM devuelve NDIS_STATUS_PENDING, debe llamar a NdisMCmCloseCallComplete posteriormente para notificar al cliente y NDIS que su intento de interrumpir la conexión se ha completado, ya sea correctamente o con un error. Una llamada a NdisMCmCloseCallComplete hace que NDIS llame a la función ProtocolClCloseCallComplete del cliente.

Si pasa NDIS_STATUS_SUCCESS como estado, el controlador MCM debe considerar el NdisVcHandle (y NdisPartyHandle, si existe) inutilizable para las transferencias a través de la red tan pronto como llame a NdisMCmCloseCallComplete. Si el controlador MCM creó originalmente el VC, debe llamar a NdisMCmDeleteVc con el mismo NdisVcHandle que acaba de pasar a NdisMCmCloseCallComplete. Si el cliente creó esta credencial verificable, el controlador MCM puede esperar una llamada a su función ProtocolCoDeleteVc con el
ProtocolVcContext, designando su estado por VC en el que ha almacenado el mismo NdisVcHandle, como parámetro de entrada.

Solo los controladores de minipuerto orientados a la conexión que proporcionan compatibilidad integrada con la administración de llamadas pueden llamar a NdisMCmCloseCallComplete. Los administradores de llamadas independientes, que se registran con NDIS como controladores de protocolo, llaman a NdisCmCloseCallComplete en su lugar.

Requisitos

Requisito	Value
Cliente mínimo compatible	Compatible con los controladores NDIS 6.0 y NDIS 5.1 (consulte NdisMCmCloseCallComplete (NDIS 5.1)) en Windows Vista. Compatible con los controladores NDIS 5.1 (consulte NdisMCmCloseCallComplete (NDIS 5.1)) en Windows XP.
Plataforma de destino	Escritorio
Encabezado	ndis.h (incluya Ndis.h)
IRQL	<= DISPATCH_LEVEL
Reglas de cumplimiento de DDI	Irql_MCM_Function(ndis)