Función NdisClIncomingCallComplete (ndis.h)

Artículo
08/07/2023

NdisClIncomingCallComplete devuelve la aceptación o rechazo de un cliente de una llamada entrante ofrecida, para la que la función ProtocolClIncomingCall del cliente devolvió anteriormente NDIS_STATUS_PENDING.

Sintaxis

void NdisClIncomingCallComplete(
  [in] NDIS_STATUS         Status,
  [in] NDIS_HANDLE         NdisVcHandle,
  [in] PCO_CALL_PARAMETERS CallParameters
);

Parámetros

[in] Status

Se establece en NDIS_STATUS_SUCCESS si el cliente acepta la llamada ofrecida. De lo contrario, este parámetro se puede establecer en cualquier NDIS_STATUS_XXX excepto NDIS_STATUS_PENDING para indicar el motivo determinado por el cliente para rechazar la llamada.

[in] NdisVcHandle

Especifica el identificador de la credencial verificable creada por el administrador de llamadas para representar la llamada entrante. El cliente obtuvo este identificador por estado de vc designado por ProtocolVcContext pasado como parámetro de entrada a su Función ProtocolClIncomingCall .

[in] CallParameters

Puntero a una estructura de tipo CO_CALL_PARAMETERS, especificando los parámetros de llamada para la llamada entrante.

Valor devuelto

None

Observaciones

Si la función ProtocolClIncomingCall de un cliente devuelve NDIS_STATUS_PENDING para una llamada ofrecida entrante en un SAP determinado, registrado previamente por el cliente con NdisClRegisterSap, el cliente debe llamar posteriormente a NdisClIncomingCallComplete para indicar si acepta o rechaza la llamada ofrecida.

Antes de llamar a NdisClIncomingCallComplete, este cliente puede negociar con el administrador de llamadas llamando a NdisClModifyCallQoS una o varias veces hasta que ambos controladores lleguen a un acuerdo sobre una calidad aceptable de servicio para la llamada entrante o el cliente determina que debe rechazar la llamada ofrecida porque sus intentos de modificar el QoS alcanzan algún límite determinado por el cliente sin dar lugar a un acuerdo.

Si el cliente ha cambiado los parámetros de llamada pasados a su función ProtocolClIncomingCall , debe establecer el miembro Flags en la estructura CO_CALL_PARAMETERS con CALL_PARAMETERS_CHANGED cuando pasa estos cambios a NdisClIncomingCallComplete. Dependiendo de si el administrador de llamadas acepta o rechaza los cambios propuestos por el cliente en los parámetros de llamada, NDIS llama posteriormente a cualquiera de los clientes. Función ProtocolClCallConnected o su Función ProtocolClIncomingCloseCall , respectivamente.

Una llamada a NdisClIncomingCallComplete hace que NDIS llame a la instancia de CM. Función ProtocolCmIncomingCallComplete . NDIS pasa los parámetros proporcionados por el cliente de NdisClIncomingCallComplete como parámetros de entrada a ProtocolCmIncomingCallComplete.

Si un cliente rechaza una llamada ofrecida estableciendo Status en algo distinto de NDIS_STATUS_SUCCESS, el cliente debe considerar que el puntero CallParameters no es válido en cuanto se produce su llamada a NdisClIncomingCallComplete .

Requisitos

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