Macro NdisMCmRegisterSapComplete (ndis.h)
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) |