Macro NdisMCmRegisterSapComplete (ndis.h)

2025-02-07

NdisMCmRegisterSapComplete devuelve el estado final de la solicitud de un cliente, para la que el controlador MCM

función protocolCmRegisterSap previamente devuelta NDIS_STATUS_PENDING para registrar un SAP.

Sintaxis

void NdisMCmRegisterSapComplete(
   _S_,
   _H_,
   _C_
);

Parámetros

_S_

Especifica el estado final de la solicitud original del cliente para registrar SAP, ya sea NDIS_STATUS_SUCCESS o cualquier NDIS_STATUS_XXXdeterminado por el autor de la llamada, excepto NDIS_STATUS_PENDING.

_H_

Especifica el identificador proporcionado por NDIS a SAP si el registro se realiza correctamente. El administrador de llamadas obtuvo este identificador como parámetro de entrada a su función ProtocolCmRegisterSap.

_C_

Especifica el identificador de un área de contexto residente proporcionada por el autor de la llamada en la que el controlador MCM mantiene el estado de este SAP si el registro se realiza correctamente. Si es así, NDIS vuelve a pasar este identificador al controlador MCM en todas las llamadas posteriores relativas a esta SAP. Si estado se establece en algo distinto de NDIS_STATUS_SUCCESS, NDIS omite este parámetro.

Valor devuelto

Ninguno

Observaciones

Un controlador MCM debe llamar a NdisMCmRegisterSapComplete si su función ProtocolCmRegisterSap devolvió NDIS_STATUS_PENDING cuando se llamó a con el NdisSapHandle especificado . La llamada a NdisMCmRegisterSapComplete hace que NDIS llame al cliente. función protocolClRegisterSapComplete.

Si el controlador MCM establece estado en algo distinto de NDIS_STATUS_SUCCESS, debe considerar el NdisSapHandle no válido cuando NdisMCmRegisterSapComplete devuelve el control. Después de que se produzca un error en el registro de SAP, cm puede liberar o reutilizar el área de contexto por SAP, si existe, que ya ha asignado. NDIS también libera su contexto para SAP si se produce un error en el registro del controlador MCM.

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

Requisitos

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