Macro NdisMCmAddPartyComplete (ndis.h)

Artículo
03/05/2024

NdisMCmAddPartyComplete devuelve el estado final de la solicitud de un cliente, para la que el controlador MCM devolvió previamente NDIS_STATUS_PENDING, para agregar una entidad en una credencial verificable de varios puntos establecida.

Sintaxis

void NdisMCmAddPartyComplete(
   _S_,
   _H_,
   _C_,
   _P_
);

Parámetros

_S_

Especifica el estado final de la operación de complemento del controlador MCM, ya sea NDIS_STATUS_SUCCESS o cualquier NDIS_STATUS_XXXexcepto NDIS_STATUS_PENDING.

_H_

Especifica el identificador que identifica a la entidad. El controlador MCM obtuvo este identificador como parámetro de entrada para su función ProtocolCmAddParty .

_C_

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

_P_

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 controlador MCM devuelve NDIS_STATUS_PENDING, el controlador debe llamar a NdisMCmAddPartyComplete posteriormente para notificar al cliente y NDIS que su intento de agregar una entidad en la credencial verificable de varios puntos se ha completado, ya sea correctamente o con un estado de error determinado por el controlador MCM.

El medio de red subyacente determina si un cliente puede especificar parámetros de tráfico por entidad en una credencial verificable de varios puntos.

Si el medio de red subyacente no admite parámetros de tráfico por entidad en máquinas virtuales de varios puntos, un controlador MCM puede realizar una de las siguientes acciones siempre que un cliente intente agregar una entidad con una especificación en CallParameters que no coincida con los parámetros de tráfico ya establecidos para esa credencial verificable:

Restablezca los parámetros de tráfico a los ya establecidos para la credencial verificable de varios puntos cuando agregue correctamente la entidad en esa credencial verificable.
Cambie los parámetros de tráfico de cada entidad que ya esté en la credencial verificable cuando agregue correctamente la nueva entidad.
Rechace la solicitud para agregar una nueva entidad. (Esta alternativa obliga implícitamente a los clientes a configurar sus parámetros de tráfico para una credencial verificable de varios puntos con NdisClMakeCall y especificar los mismos parámetros de tráfico en cada llamada posterior a NdisClAddParty para el vc multipoint dado).

Si el controlador MCM establece Status en NDIS_STATUS_SUCCESS, debe proporcionar un identificador explícito, que suele ser un puntero al área de estado por parte asignada por el controlador, como CallMgrPartyContext cuando llama a NdisMCmAddPartyComplete.

Una llamada a NdisMCmAddPartyComplete hace que NDIS llame al cliente. Función ProtocolClAddPartyComplete .

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

Requisitos

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