Función NdisCmRegisterSapComplete (ndis.h)

Artículo
02/29/2024

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 a la instancia de CM 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 administrador de llamadas independiente debe llamar a NdisCmRegisterSapComplete si su función ProtocolCmRegisterSap devolvió NDIS_STATUS_PENDING cuando se llamó con el NdisSapHandle especificado. La llamada a NdisCmRegisterSapComplete hace que NDIS llame al cliente. Función ProtocolClRegisterSapComplete .

Si el administrador de llamadas establece Status en algo distinto de NDIS_STATUS_SUCCESS, debe considerar que NdisSapHandle no es 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 se produce un error en el registro del administrador de llamadas.

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

Requisitos

Requisito	Value
Cliente mínimo compatible	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 (consulta NdisCmRegisterSapComplete (NDIS 5.1)) en Windows XP.
Plataforma de destino	Escritorio
Encabezado	ndis.h (incluya Ndis.h)
Library	Ndis.lib
IRQL	<= DISPATCH_LEVEL
Reglas de cumplimiento de DDI	Irql_CallManager_Function(ndis)