Función NdisCmAddPartyComplete (ndis.h)

Artículo
02/29/2024

NdisCmAddPartyComplete devuelve el estado final de la solicitud de un cliente, para la que el administrador de llamadas devolvió anteriormente 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

None

Observaciones

Si la función ProtocolCmAddParty de un administrador de llamadas independiente devuelve NDIS_STATUS_PENDING, el 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 la 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 la vc cuando se realizó la llamada saliente original antes de que cm llame a NdisCmAddPartyComplete con NDIS_STATUS_SUCCESS como estado .
Cambie los parámetros de tráfico para la credencial verificable y, para cada entidad conectada actualmente, a los valores proporcionados por el cliente antes de que CM llame a NdisCmAddPartyComplete con NDIS_STATUS_SUCCESS como Estado .
Produce un error en el 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 dado).

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 Status en NDIS_STATUS_SUCCESS, debe proporcionar un identificador explícito, que normalmente es un puntero al área de estado asignada por parte de 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. Los controladores de minipuerto orientados a la conexión que proporcionan compatibilidad integrada con la administración de llamadas llaman a NdisMCmAddPartyComplete en su lugar.

Requisitos

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