Función NdisCmDeactivateVc (ndis.h)

Artículo
03/05/2024

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.

El creador de una credencial verificable determinada que no se reutilizará llama a NdisCoDeleteVc para destruir esa credencial verificable.

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)