Función NdisMCoActivateVcComplete (ndis.h)
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 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
Ninguno
Observaciones
Un controlador de miniport orientado a la conexión debe llamar a NdisMCoActivateVcComplete si su función MiniportCoActivateVc devolvió previamente NDIS_STATUS_PENDING en respuesta a una solicitud para activar o reactivar la VC identificada por el NdisVcHandle dado . 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 llama a NdisMCoActivateVcComplete.
Si el controlador de miniport 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 un VC, el protocolo que creó el VC se desmontó. Si el controlador de miniporte produce un error en una solicitud para reactivar un VC establecido con nuevos parámetros de llamada, debe restaurar los parámetros de llamada originales establecidos para ese VC. En función de la naturaleza del medio de red, un controlador de miniporte puede modificar los parámetros multimedia si se establecen las marcas de redondeo o redondeo antes de llamar a NdisMCoActivateVcComplete.
Una llamada a NdisMCoActivateVcComplete hace que NDIS llame a ProtocolCmActivateVcComplete función del administrador de llamadas que originalmente solicitó la activación de VC.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | 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. |
| 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_MCO_Function(ndis) |