Función NdisMCmActivateVc (ndis.h)
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 de los medios que usa el controlador de miniporte 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.
Comentarios
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 una credencial verificable establecida.
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 acuerdo negociado con el nodo remoto o una correcta configuración de llamada en el conmutador, antes de que notifique a NDIS (y al cliente) de finalización de llamadas salientes con NdisMCmMakeCallComplete. Para una llamada entrante, un controlador MCM suele llamar 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 MiniportCoActivateVc (interna) a la 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 credencial verificable 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 puede seguir realizando transferencias en el 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 la credencial verificable. En este caso, el cliente tiene la opción de aceptar los parámetros de llamada restaurados o rechazarlos e iniciar un cierre de la credencial verificable.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Compatible con 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. |
| 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) |