Función NdisCmActivateVc (ndis.h)

Artículo
02/07/2025

NdisCmActivateVc pasa parámetros de llamada proporcionados por CM, incluidos los parámetros multimedia, para un VC determinado hasta el controlador de miniport subyacente.

Sintaxis

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

Parámetros

[in] NdisVcHandle

Especifica el identificador que identifica la credencial verificable en la que se van a establecer parámetros de llamada. El administrador de llamadas obtuvo este identificador de NdisCoCreateVc para una llamada entrante o como parámetro de entrada a su función de ProtocolCoCreateVc para una llamada saliente iniciada por el cliente.

[in, out] CallParameters

Puntero a un búfer residente asignado por CM, con formato de estructura de tipo CO_CALL_PARAMETERS, que contiene todos los parámetros específicos del medio que usa el controlador de miniporte subyacente para la activación de VC.

Valor devuelto

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

Observaciones

NdisCmActivateVc notifica al controlador de miniport subyacente para configurar los parámetros de llamada y multimedia en un VC recién creado o para cambiar los de un VC establecido. NDIS reenvía los parámetros de llamada y el controlador vc especificados a la función de del controlador de miniporte subyacente MiniportCoActivateVc, que configura todos los recursos necesarios para realizar el seguimiento del estado de la vc y se convierte en una NIC lista para transferencias de datos en el VC.

Una instancia de CM independiente siempre llama a NdisCmActivateVc después de establecer una conexión en un VC, pero antes de que se envíen o reciban datos en ese VC. Durante la conexión, un CM puede llamar a NdisCmActivateVc muchas veces con la misma NdisVcHandle como condiciones en el cambio de red y/o cada vez que el cliente llama a NdisClModifyCallQoS. En cada llamada de este tipo a NdisCmActivateVc, la función del controlador de miniport subyacente MiniportCoActivateVc debe realizar una de las siguientes acciones:

Actualice el estado que el controlador de miniporte mantiene sobre los parámetros de llamada a los nuevos valores proporcionados por el administrador de llamadas si el controlador de miniporte puede seguir realizando transferencias en el VC según los parámetros de llamada recién modificados.
Produzca un error en la llamada si el controlador de miniporte no puede continuar realizando transferencias bajo las restricciones de los parámetros de llamada especificados.

Cuando el controlador de miniport subyacente produce un error en una solicitud para establecer o restablecer parámetros de llamada, el administrador de llamadas podría modificar su especificación original en CallParameters y llamar a NdisCmActivateVc de nuevo. El límite del número de veces que cualquier administrador de llamadas realiza intentos repetidos de activar una credencial verificable depende de la implementación.

En el caso de una llamada saliente iniciada por el cliente, un CM independiente normalmente llama a NdisCmActivateVc inmediatamente después del intercambio de paquetes que confirma un contrato negociado con el destino remoto de la llamada o la configuración correcta de la llamada en el conmutador, antes de que notifique a NDIS (y al cliente) de finalización de llamadas salientes con NdisCmMakeCallComplete. Para una llamada entrante, un administrador de llamadas normalmente llama a NdisCmActivateVc después de llamar a NdisCoCreateVc correctamente y antes de llamar a NdisCmDispatchIncomingCall.

En el proceso de configurar una llamada saliente y mientras se activa cualquier vc, el cliente puede solicitar cambios en los parámetros de llamada para ese VC, por ejemplo, llamando a NdisClModifyCallQos. Después de comprobar la validez de los parámetros de llamada especificados para cualquier solicitud de este tipo, el administrador de llamadas independiente debe llamar a NdisCmActivateVc para pasar los parámetros de llamada modificados al controlador de miniport subyacente.

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

Requisitos

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