Función NdisCmRegisterSapComplete (ndis.h)

NdisCmRegisterSapComplete devuelve el estado final de la solicitud de un cliente, para la que el CM devolvió anteriormente NDIS_STATUS_PENDING, para registrar un SAP.

Sintaxis

void NdisCmRegisterSapComplete(
  [in] NDIS_STATUS Status,
  [in] NDIS_HANDLE NdisSapHandle,
  [in] NDIS_HANDLE CallMgrSapContext
);

Parámetros

[in] Status

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 CM excepto NDIS_STATUS_PENDING.

[in] NdisSapHandle

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.

[in] CallMgrSapContext

Especifica el identificador de un área de contexto residente proporcionada por el autor de la llamada en la que el CM mantiene el estado de esta SAP si el registro se realiza correctamente. Si es así, NDIS vuelve a pasar este identificador al CM 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 administrador de llamadas independiente debe llamar a NdisCmRegisterSapComplete si su función ProtocolCmRegisterSap devolvió NDIS_STATUS_PENDING cuando se llamó a con el NdisSapHandle especificado. La llamada a NdisCmRegisterSapComplete hace que NDIS llame al cliente. función protocolClRegisterSapComplete.

Si el administrador de llamadas establece estado en cualquier otro valor distinto de NDIS_STATUS_SUCCESS, debe tener en cuenta el NdisSapHandle no válido en cuanto llama a NdisCmRegisterSapComplete. Después de que se produzca un error en un registro de SAP, cm puede liberar o reutilizar el área de contexto por SAP que asignó cuando NdisCmRegisterSapComplete devuelve el control . NDIS también libera su contexto para SAP si el administrador de llamadas produce un error en el registro.

Solo los administradores de llamadas independientes, que se registran con NDIS como controladores de protocolo, pueden llamar a NdisCmRegisterSapComplete. Controladores de miniport orientados a la conexión que proporcionan llamadas integradas de soporte técnico de administración de llamadas NdisMCmRegisterSapComplete.

Requisitos

Requisito	Valor
cliente mínimo admitido	Compatible con los controladores NDIS 6.0 y NDIS 5.1 (consulte NdisCmRegisterSapComplete (NDIS 5.1)) en Windows Vista. Compatible con los controladores NDIS 5.1 (consulte NdisCmRegisterSapComplete (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_CallManager_Function(ndis)

Consulte también

NdisAllocateFromNPagedLookasideList

NdisClRegisterSap

NdisMCmRegisterSapComplete

ProtocolClRegisterSapComplete

ProtocolCmRegisterSap de