Función NdisCmDeactivateVc (ndis.h)
NdisCmDeactivateVc notifica a NDIS y al controlador de miniport 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ó el VC 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.
Observaciones
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 del controlador de miniport subyacente MiniportCoDeactivateVc, que puede descartar los parámetros de llamada actuales para las transferencias en el VC, lo que posiblemente reinicializa los valores predeterminados del controlador de miniportar. Si el VC se reactiva posteriormente para otra llamada, el cliente o el administrador de llamadas proporcionarán nuevos parámetros de llamada al controlador de miniport.
El 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 un VC 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 miniport orientados a la conexión que proporcionan una llamada integrada de soporte técnico de administración de llamadas NdisMCmDeactivateVc.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | 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 (consulte NdisCmDeactivateVc (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) |