Macro NdisMCmRegisterSapComplete (ndis.h)

Artículo
03/08/2023

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

La función ProtocolCmRegisterSap devolvió anteriormente NDIS_STATUS_PENDING, para registrar una instancia de 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_XXX determinado 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 para 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 este SAP. Si Status se establece en algo distinto de NDIS_STATUS_SUCCESS, NDIS omite este parámetro.

Valor devuelto

None

Observaciones

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

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

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