Macro NdisMCmCloseCallComplete (ndis.h)

2025-02-07

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 cierra 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 vc de la llamada. El controlador MCM con NdisMCmCreateVc o como parámetro de entrada para su función de ProtocolCoCreate Vc proporciona este identificador.

_PH_

Especifica NULL si el 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 parte designado por el CallMgrPartyContext pasado como parámetro de entrada a su función protocolCmCloseCall.

Valor devuelto

Ninguno

Observaciones

Si la función ProtocolCmCloseCall de un controlador MCM devuelve NDIS_STATUS_PENDING, debe llamar a NdisMCmCloseCallComplete después notificar al cliente y a 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 de, el controlador MCM debe considerar la NdisVcHandle (y NdisPartyHandle, si existe) inutilizable para las transferencias a través de la red en cuanto llama a NdisMCmCloseCallComplete. Si el controlador MCM creó originalmente el VC, debe llamar a NdisMCmDeleteVc con la misma NdisVcHandle que acaba de pasar a NdisMCmCloseCallComplete. Si el cliente creó este VC, el controlador MCM puede esperar una llamada a su ProtocolCoDeleteVc función 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 miniport 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	Valor
cliente mínimo admitido	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.
de la plataforma de destino de	Escritorio
encabezado de	ndis.h (incluya Ndis.h)
irQL	<= DISPATCH_LEVEL
reglas de cumplimiento de DDI	Irql_MCM_Function(ndis)