Función NdisMCmActivateVc (ndis.h)

2025-02-07

NdisMCmActivateVc notifica a NDIS que un controlador MCM está listo para realizar transferencias en un VC determinado.

Sintaxis

NDIS_STATUS NdisMCmActivateVc(
  [in] NDIS_HANDLE         NdisVcHandle,
  [in] PCO_CALL_PARAMETERS CallParameters
);

Parámetros

[in] NdisVcHandle

Especifica el identificador que identifica la credencial verificable.

[in] CallParameters

Puntero a un búfer asignado por el autor de la llamada, con formato de estructura de tipo CO_CALL_PARAMETERS, que contiene todos los parámetros específicos del medio que el controlador de miniporte usa para el VC activado.

Valor devuelto

Cuando NdisMCmActivateVc devuelve algo distinto de NDIS_STATUS_PENDING, el controlador MCM debe realizar una llamada interna a su función protocolCmActivateVcComplete. De lo contrario, NDIS llama a la función ProtocolCmActivateVcComplete del controlador MCM cuando se completa esta operación.

Observaciones

NdisMCmActivateVc informa a NDIS de que un controlador MCM ha configurado parámetros de llamada y multimedia en un VC recién creado o ha cambiado los parámetros de llamada en un VC establecido.

Un controlador MCM debe llamar a NdisMCmActivateVc después de establecer una conexión en un VC, pero antes de que se envíen o reciban datos en ese VC. Esta llamada notifica a NDIS que el controlador de miniporte ha hecho una NIC lista para transferencias en el VC.

En el caso de una llamada saliente iniciada por el cliente, un controlador MCM normalmente llama a NdisMCmActivateVc después del protocolo de enlace que indica un contrato negociado con el nodo remoto o la instalación correcta de llamadas en el conmutador, antes de que notifique a NDIS (y al cliente) la finalización de la llamada saliente con NdisMCmMakeCallComplete. Para una llamada entrante, un controlador MCM normalmente llama a NdisMCmActivateVc después de llamar a NdisMCmCreateVc correctamente y antes de llamar a NdisMCmDispatchIncomingCall.

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

Durante la conexión, un controlador MCM puede modificar los parámetros de llamada como condiciones en el cambio de red o cada vez que el cliente llama a NdisClModifyCallQoS. El controlador MCM debe actualizar el estado que mantiene sobre los parámetros de llamada a los nuevos valores si puede continuar realizando transferencias en el VC según los parámetros de llamada recién modificados. Debe llamar a NdisMCmActivateVc para notificar a NDIS cualquier cambio en los parámetros de llamada para la vc activa. De lo contrario, el controlador MCM puede realizar una de las siguientes acciones:

Llame a NdisMCmDeactivateVc después de que se produce un error en la solicitud del cliente para modificar QoS u otros parámetros de llamada para el VC a tal estado que el controlador de miniporte no pueda seguir realizando transferencias en la vc.
Restaure los parámetros de llamada a un estado aceptado previamente, notifique al cliente que solicitó el cambio y permanezca listo para continuar transfiriendo datos en el VC. En este caso, el cliente tiene la opción de aceptar los parámetros de llamada restaurados o rechazarlos e iniciar un cierre del VC.

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

Requisitos

Requisito	Valor
cliente mínimo admitido	Compatible con los controladores NDIS 6.0 y NDIS 5.1 (consulte NdisMCmActivateVc (NDIS 5.1)) en Windows Vista. Compatible con controladores NDIS 5.1 (consulte NdisMCmActivateVc (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_MCM_Function(ndis)