Función NdisCmCloseCallComplete (ndis.h)

NdisCmCloseCallComplete devuelve el estado final de la solicitud de un cliente, para la que el administrador de llamadas devolvió previamente NDIS_STATUS_PENDING, para anular una llamada.

Sintaxis

void NdisCmCloseCallComplete(
  [in]           NDIS_STATUS Status,
  [in]           NDIS_HANDLE NdisVcHandle,
  [in, optional] NDIS_HANDLE NdisPartyHandle
);

Parámetros

[in] Status

Especifica el estado final de la solicitud del cliente de que la instancia de CM cierra la conexión, ya sea NDIS_STATUS_SUCCESS o cualquier NDIS_STATUS_XXX determinada por CM, excepto NDIS_STATUS_PENDING.

[in] NdisVcHandle

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 administrador de llamadas o el cliente, con NdisCoCreateVc. Más recientemente, el administrador de llamadas obtuvo este identificador de su estado por VC designado por CallMgrVcContext pasado como parámetro de entrada a su Función ProtocolCmCloseCall .

[in, optional] NdisPartyHandle

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 CM obtenido de su estado por parte designado por CallMgrPartyContext pasó como parámetro de entrada a su función ProtocolCmCloseCall .

Valor devuelto

None

Observaciones

Si la función ProtocolCmCloseCall de un administrador de llamadas independiente devuelve NDIS_STATUS_PENDING, CM debe llamar a NdisCmCloseCallComplete 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 NdisCmCloseCallComplete hace que NDIS llame al cliente. Función ProtocolClCloseCallComplete .

Si pasa NDIS_STATUS_SUCCESS como estado, el administrador de llamadas debe considerar el NdisVcHandle (y NdisPartyHandle, si existe) inutilizable para las transferencias a través de la red tan pronto como llame a NdisCmCloseCallComplete. Si el administrador de llamadas creó originalmente el VC, debe llamar a NdisCoDeleteVc con el mismo NdisVcHandle que acaba de pasar a NdisCmCloseCallComplete. Si el cliente creó esta credencial verificable, el administrador de llamadas puede esperar una llamada a su función ProtocolCoDeleteVc con el
ProtocolVcContext, donde tiene el mismo NdisVcHandle, que un parámetro de entrada.

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

Requisitos

Consulte también

NdisClCloseCall

NdisCoDeleteVc

NdisMCmCloseCallComplete

ProtocolClCloseCallComplete

ProtocolCoDeleteVc