Función NdisMCmDeleteVc (ndis.h)

Artículo
02/26/2024

NdisMCmDeleteVc destruye un VC creado por el autor de la llamada.

Sintaxis

NDIS_STATUS NdisMCmDeleteVc(
  [in] NDIS_HANDLE NdisVcHandle
);

Parámetros

[in] NdisVcHandle

Especifica el identificador que identifica la credencial verificable que se va a eliminar. El autor de la llamada obtuvo originalmente este identificador de NdisMCmCreateVc.

Valor devuelto

NdisMCmDeleteVc puede devolver una de las siguientes opciones:

Código devuelto	Descripción
NDIS_STATUS_SUCCESS	NDIS eliminó la credencial verificable.
NDIS_STATUS_NOT_ACCEPTED	La credencial verificable sigue activa, por lo que no se pudo eliminar.

Comentarios

Cuando un controlador MCM llama a NdisMCmDeleteVc, no debe haber llamadas pendientes en el VC especificado y que debe haberse desactivado. Para cumplir estos requisitos, implica que el controlador MCM ya ha llamado a NdisMCmDeactivateVc con el NdisVcHandle dado correctamente.

Solo el controlador que creó una credencial verificable determinada puede eliminar esa credencial verificable. Una llamada a NdisMCmDeleteVc hace que NDIS llame a la función ProtocolCoDeleteVc del cliente con el que el autor de la llamada comparte NdisVcHandle .

Cuando NdisMCmDeleteVc devuelve el control , NdisVcHandle ya no es válido. El controlador MCM puede liberar los recursos que asignó para mantener el estado sobre el VC eliminado o prepararlos para su reutilización en una notificación de llamada entrante posterior después de llamar a NdisMCmCreateVc.

El escritor de controladores determina si un controlador MCM tiene una función MiniportCoDeleteVc (interna) a la que llama el controlador en el contexto de anular las conexiones para las llamadas salientes y entrantes.

Solo los controladores de minipuerto orientados a la conexión que proporcionan compatibilidad integrada con la administración de llamadas pueden llamar a NdisMCmDeleteVc. Los administradores de llamadas independientes y los clientes, que se registran con NDIS como controladores de protocolo, llaman a NdisCoDeleteVc en su lugar.

Requisitos

Requisito	Value
Cliente mínimo compatible	Compatible con controladores NDIS 6.0 y NDIS 5.1 (consulte NdisMCmDeleteVc (NDIS 5.1)) en Windows Vista. Compatible con los controladores NDIS 5.1 (consulte NdisMCmDeleteVc (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)