Función NdisMCoActivateVcComplete (ndis.h)

Artículo
08/07/2023

NdisMCoActivateVcComplete notifica a NDIS y al administrador de llamadas que el controlador de miniporte ha terminado de procesar una solicitud activate-VC iniciada por CM, para la que el controlador de miniporte devolvió previamente NDIS_STATUS_PENDING.

Sintaxis

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

Parámetros

[in] Status

Especifica el estado final de la operación activate-VC, que puede ser NDIS_STATUS_SUCCESS o cualquier NDIS_STATUS_ XXX excepto NDIS_STATUS_PENDING.

[in] NdisVcHandle

Especifica el identificador que identifica la credencial verificable. El autor de la llamada obtuvo este identificador a partir de su estado por VC, designado por el MiniportVcContext pasado como parámetro de entrada a su Función MiniportCoActivateVc .

[in] CallParameters

Puntero a una estructura de tipo CO_CALL_PARAMETERS, proporcionada por el administrador de llamadas, especificando los parámetros de llamada y multimedia para la activación de VC.

Valor devuelto

None

Observaciones

Un controlador de minipuerto orientado a la conexión debe llamar a NdisMCoActivateVcComplete si su función MiniportCoActivateVc devolvió anteriormente NDIS_STATUS_PENDING en respuesta a una solicitud para activar o reactivar el VC identificado por el dado NdisVcHandle . El administrador de llamadas, que inició la activación de VC con una llamada a NdisCmActivateVc, no puede notificar a NDIS ni a su cliente si se pueden realizar transferencias en el VC mediante los parámetros de llamada proporcionados hasta que el controlador de miniporte llame a NdisMCoActivateVcComplete.

Si el controlador de minipuerto encuentra los parámetros de llamada proporcionados por CM inaceptables, se produce un error en la activación de VC cuando llama a NdisMCoActivateVcComplete. Si se produce un error en la activación inicial de una credencial verificable, el protocolo que creó la credencial verificable se puede anular. Si el controlador de minipuerto produce un error en una solicitud para reactivar una credencial verificable establecida con nuevos parámetros de llamada, debe restaurar los parámetros de llamada originales establecidos para esa vc. Dependiendo de la naturaleza del medio de red, un controlador de minipuerto puede modificar los parámetros multimedia si las marcas de redondeo o redondeo se establecen antes de llamar a NdisMCoActivateVcComplete.

Una llamada a NdisMCoActivateVcComplete hace que NDIS llame a ProtocolCmActivateVcComplete función del administrador de llamadas que solicitó originalmente la activación de VC.

Requisitos

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

Consulte también

ProtocolCmActivateVcComplete