Compartir a través de


Macro NdisMCmDispatchIncomingDropParty (ndis.h)

NdisMCmDispatchIncomingDropParty notifica a un cliente que debe quitar una entidad determinada en una credencial verificable de varios puntos.

Sintaxis

void NdisMCmDispatchIncomingDropParty(
   _S_,
   _H_,
   _B_,
   _Z_
);

Parámetros

_S_

Indica la razón por la que se quita esta entidad, normalmente NDIS_STATUS_SUCCESS si la parte remota simplemente solicitó que se cerrara su conexión.

_H_

Especifica el identificador que identifica la entidad que se va a quitar de la credencial verificable de varios puntos, que debe tener otras partes que todavía están conectadas. El controlador MCM obtuvo originalmente este identificador como parámetro de entrada para su función ProtocolCmAddParty .

_B_

Puntero a un búfer residente asignado por el autor de la llamada que contiene datos adicionales específicos del protocolo recibidos de la entidad remota, si existe. Dependiendo del medio subyacente, este puntero puede ser NULL.

_Z_

Especifica el tamaño en bytes del búfer, cero si Buffer es NULL.

Valor devuelto

None

Observaciones

En el curso de las operaciones de red normales, un controlador MCM llama a NdisMCmDispatchIncomingDropParty con closeStatus establecido en NDIS_STATUS_SUCCESS porque un cliente remoto en una conexión multipunto ha llamado a NdisClCloseCall.

Sin embargo, un controlador MCM también puede llamar a NdisMCmDispatchIncomingDropParty con un CloseStatus determinado por el controlador en el behest de la propia red si se producen condiciones de red anómalos, como el error de un conmutador en la ruta de acceso entre el cliente local y uno o varios clientes en una conexión multipunto establecida.

Una llamada a NdisMCmDispatchIncomingDropParty hace que NDIS llame al cliente Función ProtocolClIncomingDropParty .

Si NdisPartyHandle identifica la última entidad restante en la credencial verificable especificada, el controlador MCM llama a . NdisMCmDispatchIncomingCloseCall, en lugar de NdisMCmDispatchIncomingDropParty.

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

Requisitos

Requisito Value
Cliente mínimo compatible Compatible con los controladores NDIS 6.0 y NDIS 5.1 (consulte NdisMCmDispatchIncomingDropParty (NDIS 5.1)) en Windows Vista. Compatible con los controladores NDIS 5.1 (consulta NdisMCmDispatchIncomingDropParty (NDIS 5.1)) en Windows XP.
Plataforma de destino Escritorio
Encabezado ndis.h (incluya Ndis.h)
IRQL <= DISPATCH_LEVEL
Reglas de cumplimiento de DDI Irql_MCM_Function(ndis)

Consulte también

MiniportInterruptDPC

NdisClDropParty

NdisCmDispatchIncomingDropParty NdisMCmDispatchIncomingCloseCall

ProtocolClIncomingDropParty