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 el CM cierra la conexión, ya sea NDIS_STATUS_SUCCESS o cualquier NDIS_STATUS_XXX determinado por CM, excepto NDIS_STATUS_PENDING.
[in] NdisVcHandle
Especifica el identificador para la vc de la llamada. Este identificador lo proporcionó NDIS cuando el VC se creó originalmente, 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 el CallMgrVcContext pasado como parámetro de entrada a su función protocolCmCloseCall.
[in, optional] NdisPartyHandle
Especifica NULL si el NdisVcHandle representa un VC de punto a punto o el identificador de la última parte restante en una conexión de varios puntos, que el CM 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 de ProtocolCmCloseCall de un administrador de llamadas independiente devuelve NDIS_STATUS_PENDING, la instancia de CM debe llamar a NdisCmCloseCallComplete posteriormente notificar al cliente y al 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 tener en cuenta el NdisVcHandle (y NdisPartyHandle, si existe) inutilizable para las transferencias a través de la red en cuanto llama a NdisCmCloseCallComplete. Si el administrador de llamadas creó originalmente el VC, debe llamar a NdisCoDeleteVc con la misma NdisVcHandle que acaba de pasar a NdisCmCloseCallComplete. Si el cliente creó este VC, el administrador de llamadas puede esperar una llamada a su ProtocolCoDeleteVc función con el
ProtocolVcContext, donde tiene el mismo NdisVcHandle, como parámetro de entrada.
Solo los administradores de llamadas independientes, que se registran con NDIS como controladores de protocolo, pueden llamar a NdisCmCloseCallComplete. En su lugar, los controladores de miniport orientados a la conexión que proporcionan una llamada integrada de administración de llamadas NdisMCmCloseCallComplete.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Compatible con los controladores NDIS 6.0 y NDIS 5.1 (consulte NdisCmCloseCallComplete (NDIS 5.1)) en Windows Vista. Compatible con los controladores NDIS 5.1 (consulte NdisCmCloseCallComplete (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) |