Función NdisCmNotifyCloseAddressFamily (ndis.h)

Artículo
02/29/2024

La función NdisCmNotifyCloseAddressFamily notifica a NDIS que un administrador de llamadas se desenlace de 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. Función ProtocolCmNotifyCloseAfComplete 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.

Comentarios

Administradores de llamadas de CoNDIS independientes, que se registran como controladores de protocolo NDIS mediante una llamada a La función NdisRegisterProtocolDriver puede llamar a la función NdisCmNotifyCloseAddressFamily . En su lugar, los administradores de llamadas de miniporte (MCM) llaman 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, el NDIS llama a Función ProtocolClNotifyCloseAf 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	Value
Cliente mínimo compatible	Compatible con NDIS 6.0 y versiones posteriores.
Plataforma de destino	Escritorio
Encabezado	ndis.h (incluya Ndis.h)
Library	Ndis.lib
IRQL	PASSIVE_LEVEL
Reglas de cumplimiento de DDI	Irql_CallManager_Function(ndis)