Función NdisCmAddPartyComplete (ndis.h)

Artículo
02/07/2025

NdisCmAddPartyComplete devuelve el estado final de la solicitud de un cliente, para la que el administrador de llamadas devolvió previamente NDIS_STATUS_PENDING, para agregar una entidad en un VC de varios puntos establecido.

Sintaxis

void NdisCmAddPartyComplete(
  [in]           NDIS_STATUS         Status,
  [in]           NDIS_HANDLE         NdisPartyHandle,
  [in, optional] NDIS_HANDLE         CallMgrPartyContext,
  [in]           PCO_CALL_PARAMETERS CallParameters
);

Parámetros

[in] Status

Especifica el estado final de la operación de complemento del administrador de llamadas, ya sea NDIS_STATUS_SUCCESS o cualquier NDIS_STATUS_XXX excepto NDIS_STATUS_PENDING.

[in] NdisPartyHandle

Especifica el identificador que identifica a la entidad. Este identificador se ha introducido en la función protocolCmAddParty del administrador de llamadas.

[in, optional] CallMgrPartyContext

Especifica el identificador de un área de contexto residente asignada por el autor de la llamada en la que el administrador de llamadas mantendrá información de estado específica de la entidad si la operación del complemento se realizó correctamente. De lo contrario, este parámetro puede ser NULL porque se omite.

[in] CallParameters

Puntero a una estructura de tipo CO_CALL_PARAMETERS que contiene los parámetros de llamada, proporcionados originalmente por el cliente, para que se agregue la entidad.

Valor devuelto

Ninguno

Observaciones

Si la función protocolCmAddParty de un administrador de llamadas independiente devuelve NDIS_STATUS_PENDING, la instancia de CM debe llamar posteriormente a NdisCmAddPartyComplete para notificar al cliente y NDIS que su intento de agregar una entidad en el VC de varios puntos se ha completado, ya sea correctamente o con un error.

Si el cliente pasó parámetros de tráfico en CallParameters que no coincidieron con los ya establecidos para el vc de varios puntos, el diseñador del administrador de llamadas debe determinar cómo controlar esta condición, sujeto a las restricciones impuestas por el medio de red. Entre las posibilidades se incluyen las siguientes:

Configure los parámetros de tráfico por entidad si el medio de red subyacente admite esta característica en máquinas virtuales de varios puntos.
Restablezca los parámetros de tráfico proporcionados por el cliente a los establecidos para el VC cuando se realizó la llamada saliente original antes de que la cm llame a NdisCmAddPartyComplete con NDIS_STATUS_SUCCESS como Status .
Cambie los parámetros de tráfico para la vc y, para cada entidad conectada actualmente en él, a los valores proporcionados por el cliente antes de que cm llame a NdisCmAddPartyComplete con NDIS_STATUS_SUCCESS como estado de .
Error al intento del cliente de agregar una entidad. (Esta alternativa obliga implícitamente a los clientes a configurar sus parámetros de tráfico para un VC de varios puntos con NdisClMakeCall y especificar los mismos parámetros de tráfico en cada llamada posterior a NdisClAddParty para el vc de varios puntos dados).

Para algunos medios orientados a la conexión, los parámetros de tráfico son por VC por naturaleza y, por lo tanto, idénticos para todas las partes en un VC de varios puntos.

Si cm establece estado en NDIS_STATUS_SUCCESS, debe proporcionar un identificador explícito, que suele ser un puntero al área de estado por parte asignada por CM, como CallMgrPartyContext cuando llama a NdisCmAddPartyComplete.

Una llamada a NdisCmAddPartyComplete hace que NDIS llame al cliente. función protocolClAddPartyComplete.

Solo los administradores de llamadas independientes, que se registran con NDIS como controladores de protocolo, pueden llamar a NdisCmAddPartyComplete. En su lugar, los controladores de miniport orientados a la conexión que proporcionan una llamada integrada de soporte técnico de administración de llamadas NdisMCmAddPartyComplete.

Requisitos

Requisito	Valor
cliente mínimo admitido	Compatible con controladores NDIS 6.0 y NDIS 5.1 (consulte NdisCmAddPartyComplete (NDIS 5.1)) en Windows Vista. Compatible con los controladores NDIS 5.1 (consulte NdisCmAddPartyComplete (NDIS 5.1)) en Windows XP.
de la plataforma de destino de	Escritorio
encabezado de	ndis.h (incluya Ndis.h)
biblioteca de	Ndis.lib
irQL	<= DISPATCH_LEVEL
reglas de cumplimiento de DDI	Irql_CallManager_Function(ndis)