Función NdisCmNotifyCloseAddressFamily (ndis.h)

Artículo
02/07/2025

La función NdisCmNotifyCloseAddressFamily notifica a NDIS que un administrador de llamadas está desenlazando desde un adaptador de miniport subyacente y que los clientes de CoNDIS asociados deben cerrar la familia de direcciones especificada (AF).

Sintaxis

NDIS_STATUS NdisCmNotifyCloseAddressFamily(
  [in] NDIS_HANDLE NdisAfHandle
);

Parámetros

[in] NdisAfHandle

Identificador NDIS que identifica el AF que debe cerrar NDIS. NDIS proporcionó este identificador a la función protocolCmOpenAf del administrador de llamadas.

Valor devuelto

NdisCmNotifyCloseAddressFamily puede devolver una de las siguientes opciones:

Código devuelto	Descripción
NDIS_STATUS_SUCCESS	NDIS cerró correctamente la familia de direcciones.
NDIS_STATUS_PENDING	NDIS controla esta solicitud de forma asincrónica y llamará al administrador de llamadas. protocolCmNotifyCloseAfComplete función cuando se completa la operación de cierre.
NDIS_STATUS_XXX	NDIS produjo un error en la solicitud de algún motivo determinado por el controlador de cliente o NDIS.

Observaciones

Administradores de llamadas de CoNDIS independientes, que se registran como controladores de protocolo NDIS mediante una llamada a función NdisRegisterProtocolDriver, puede llamar a la función NdisCmNotifyCloseAddressFamily. Miniport call managers (MCM) en su lugar llama a función NdisMCmNotifyCloseAddressFamily.

Para cerrar un AF para un enlace, el administrador de llamadas independiente debe llamar a NdisCmNotifyCloseAddressFamily desde el función ProtocolUnbindAdapterEx. A continuación, NDIS llama a ProtocolClNotifyCloseAf función del cliente que tiene abierto el AF especificado.

Si NdisCmNotifyCloseAddressFamily devuelve NDIS_STATUS_PENDING, NDIS llama al administrador de llamadas. función ProtocolCmNotifyCloseAfComplete después de que el cliente complete la operación de cierre de AF.

Requisitos

Requisito	Valor
cliente mínimo admitido	Se admite en NDIS 6.0 y versiones posteriores.
de la plataforma de destino de	Escritorio
encabezado de	ndis.h (incluya Ndis.h)
biblioteca de	Ndis.lib
irQL	PASSIVE_LEVEL
reglas de cumplimiento de DDI	Irql_CallManager_Function(ndis)