Función NdisCmDispatchIncomingDropParty (ndis.h)

  • Artículo

NdisCmDispatchIncomingDropParty notifica a un cliente que debe quitar una entidad determinada en un VC de varios puntos, normalmente porque el administrador de llamadas ha recibido una solicitud a través de la red para cerrar una conexión multipoint activa.

Sintaxis

void NdisCmDispatchIncomingDropParty(
  [in]           NDIS_STATUS DropStatus,
  [in]           NDIS_HANDLE NdisPartyHandle,
  [in, optional] PVOID       Buffer,
  [in]           UINT        Size
);

Parámetros

[in] DropStatus

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

[in] NdisPartyHandle

Especifica el identificador que identifica la entidad que se va a quitar de la credencial verificable de varios puntos, que debe tener otras partes conectadas.

[in, optional] Buffer

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.

[in] Size

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

Valor devuelto

None

Observaciones

En el curso de las operaciones de red normales, un administrador de llamadas independiente La función ProtocolCoReceiveNetBufferLists llama a NdisCmDispatchIncomingDropParty con closeStatus establecido en NDIS_STATUS_SUCCESS porque un cliente remoto en una conexión de varios puntos ha llamado a NdisClCloseCall.

Sin embargo, un administrador de llamadas también puede llamar a NdisCmDispatchIncomingDropParty con un CloseStatus determinado por CM en el estado más alto de la propia red si se producen condiciones de red anómalas, como el error de un conmutador en la ruta de acceso entre el cliente local y uno o varios clientes en una conexión multipoint establecida.

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

Si NdisPartyHandle identifica la última parte restante en la credencial verificable especificada, el CM llama a . NdisCmDispatchIncomingCloseCall, en lugar de NdisCmDispatchIncomingDropParty.

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

Requisitos

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

Consulte también

NdisClDropParty

NdisCmDispatchIncomingCloseCall NdisMCmDispatchIncomingDropParty

ProtocolClIncomingDropParty

ProtocolCoReceiveNetBufferLists