Función NdisMCmDeactivateVc (ndis.h)

Artículo
02/29/2024

NdisMCmDeactivateVc notifica a NDIS que no habrá más transferencias en un VC activo determinado.

Sintaxis

NDIS_STATUS NdisMCmDeactivateVc(
  [in] NDIS_HANDLE NdisVcHandle
);

Parámetros

[in] NdisVcHandle

Especifica el identificador que identifica la credencial verificable. NDIS proporcionó este identificador al controlador MCM cuando llamó a NdisMCmCreateVc para una llamada entrante o cuando su función ProtocolCoCreateVc configuró el VC para una llamada saliente iniciada por el cliente.

Valor devuelto

NdisMCmDeactivateVc puede devolver una de las siguientes opciones:

Código devuelto	Descripción
NDIS_STATUS_SUCCESS	NDIS marcó la credencial verificable como inactiva.
NDIS_STATUS_NOT_ACCEPTED	La credencial verificable ya está desactivada, por lo que esta llamada es redundante.

Comentarios

Un controlador MCM llama a NdisMCmDeactivateVc como un paso esencial para cerrar una llamada, normalmente después del intercambio de paquetes con componentes de red que desgarran la conexión.

Una llamada correcta a NdisMCmDeactivateVc permite al controlador MCM descartar los parámetros de llamada actuales para las transferencias en el VC, posiblemente reinicializarlos en los valores predeterminados determinados por el controlador de miniport. Sin embargo, si la credencial verificable se reactiva posteriormente para otra llamada, el cliente proporcionará nuevos parámetros de llamada al controlador de minipuerto.

NdisVcHandle pasado a NdisMCmDeactivateVc sigue siendo válido una vez completada la desactivación de VC. La desactivación de cualquier VC permite a su creador reinicializar la credencial verificable para reutilizarla o destruirla:

Después de la desactivación de VC y el cierre de la llamada, un cliente puede reutilizar un VC que creó originalmente para realizar otra llamada con NdisClMakeCall, o puede llamar a NdisCoDeleteVc, lo que provoca una llamada a la función ProtocolCoDeleteVc del controlador MCM.
Después de la desactivación de VC y el cierre de la llamada, un controlador MCM puede reutilizar un VC que creó originalmente para indicar otra llamada entrante al mismo cliente con NdisMCmDispatchIncomingCall, o puede llamar a NdisMCmDeleteVc.

El escritor de controladores determina si un controlador MCM tiene una función MiniportCoDeactivateVc (interna) a la que llama el controlador en el contexto de anular las conexiones para las llamadas salientes y entrantes.

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

Requisitos

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