Función NdisCmDeactivateVc (ndis.h)
NdisCmDeactivateVc notifica a NDIS y al controlador de miniporte subyacente que no habrá más transferencias en un VC activo determinado.
Sintaxis
NDIS_STATUS NdisCmDeactivateVc(
[in] NDIS_HANDLE NdisVcHandle
);
Parámetros
[in] NdisVcHandle
Especifica el identificador que identifica la credencial verificable. NDIS proporcionó este identificador al administrador de llamadas cuando llamó a NdisCoCreateVc para una llamada entrante o cuando su función ProtocolCoCreateVc configuró la credencial verificable para una llamada saliente iniciada por el cliente.
Valor devuelto
Cuando NdisCmDeactivateVc devuelve algo distinto de NDIS_STATUS_PENDING, el administrador de llamadas debe realizar una llamada interna a su Función ProtocolCmDeactivateVcComplete . De lo contrario, NDIS llama a la función ProtocolCmDeactivateVcComplete de CM cuando se completa esta operación.
Comentarios
Un administrador de llamadas independiente llama a NdisCmDeactivateVc como un paso esencial para cerrar una llamada, normalmente después del intercambio de paquetes con componentes de red que desgarran la llamada.
Una llamada a NdisCmDeactivateVc hace que NDIS llame a la función MiniportCoDeactivateVc del controlador de miniport subyacente, que puede descartar los parámetros de llamada actuales para las transferencias en la credencial verificable, posiblemente reinicializarlos para miniportar valores predeterminados determinados por el controlador. Si la credencial verificable se reactiva posteriormente para otra llamada, el cliente o el administrador de llamadas proporcionará nuevos parámetros de llamada al controlador de minipuerto.
NdisVcHandle pasado a NdisCmDeactivateVc sigue siendo válido después de que se complete la desactivación de VC. La desactivación de cualquier vc permite a su creador reinicializar la credencial verificable para su reutilización:
- 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.
- Después de la desactivación de VC y el cierre de la llamada, un CM puede reutilizar una credencial verificable que creó originalmente para indicar otra llamada entrante al mismo cliente con NdisCmDispatchIncomingCall.
Solo los administradores de llamadas independientes, que se registran con NDIS como controladores de protocolo, pueden llamar a NdisCmDeactivateVc. En su lugar, los controladores de minipuerto orientados a la conexión que proporcionan compatibilidad integrada con la administración de llamadas llaman a NdisMCmDeactivateVc .
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Compatible con los controladores NDIS 6.0 y NDIS 5.1 (consulte NdisCmDeactivateVc (NDIS 5.1)) en Windows Vista. Compatible con los controladores NDIS 5.1 (consulta NdisCmDeactivateVc (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_CallManager_Function(ndis) |