Macro NdisMCmDispatchIncomingCall (ndis.h)

Artículo
08/07/2023

NdisMCmDispatchIncomingCall informa al cliente de una llamada entrante en un SAP registrado previamente por ese cliente con el controlador MCM.

Sintaxis

void NdisMCmDispatchIncomingCall(
   _SH_,
   _VH_,
   _CP_
);

Parámetros

_SH_

Especifica el identificador que identifica sap. NDIS configura este identificador cuando el cliente llamado originalmente NdisClRegisterSap y el controlador MCM obtuvo este identificador como parámetro de entrada a su Función ProtocolCmRegisterSap .

_VH_

Especifica el identificador que identifica el VC, creado con NdisMCmCreateVc cuando el controlador MCM procesa la oferta de llamada entrante dirigida a este SAP registrado.

_CP_

Puntero a una estructura de tipo CO_CALL_PARAMETERS que especifica los parámetros de llamada y multimedia para la credencial verificable.

Valor devuelto

None

Observaciones

Antes de llamar a NdisMCmDispatchIncomingCall, un controlador MCM ya ha hecho lo siguiente:

Se identificó el SAP de destino, registrado previamente por un cliente determinado, para la llamada (en realidad, una solicitud para realizar una conexión) que recibió a través de la red.
Se ha creado una credencial verificable para la llamada entrante con NdisMCmCreateVc
Posiblemente negociados sobre los parámetros de llamada aceptables a través de la red, o aceptaron los parámetros de llamada enviados desde el nodo remoto
Ha activado el VC con NdisMCmActivateVc para notificar a NDIS que está listo para las transferencias en la credencial verificable de acuerdo con los parámetros de llamada negociados o aceptados.

La llamada del controlador MCM a NdisMCmDispatchIncomingCall hace que NDIS llame a la función ProtocolClIncomingCall del cliente, dentro de la cual el cliente acepta o rechaza la conexión solicitada. Después de decidir si aceptar la conexión, el cliente llama a NdisClIncomingCallComplete, que, a su vez, llama a la función ProtocolCmIncomingCallComplete del controlador MCM. Si el cliente aceptó la llamada, el controlador MCM llama a continuación. NdisMCmDispatchCallConnected. De lo contrario, desactiva (y posiblemente elimina) el VC que creó, después de notificar al nodo remoto que se rechazó la llamada ofrecida.

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

Requisitos

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