PROTOCOL_CM_NOTIFY_CLOSE_AF_COMPLETE función de devolución de llamada (ndis.h)

La función ProtocolCmNotifyCloseAfComplete indica que un cliente ha completado el cierre de una familia de direcciones (AF) que un administrador de llamadas independiente o un administrador de llamadas de minipuerto (MCM) iniciado llamando al NdisCmNotifyCloseAddressFamily o Función NdisMCmNotifyCloseAddressFamily , respectivamente.

Nota Debe declarar la función mediante el tipo PROTOCOL_CM_NOTIFY_CLOSE_AF_COMPLETE . Para obtener más información, consulte la sección Ejemplos siguientes.

 

Sintaxis

PROTOCOL_CM_NOTIFY_CLOSE_AF_COMPLETE ProtocolCmNotifyCloseAfComplete;

void ProtocolCmNotifyCloseAfComplete(
  [in] NDIS_HANDLE CallMgrAfContext,
  [in] NDIS_STATUS Status
)
{...}

Parámetros

[in] CallMgrAfContext

Identificador del área de contexto af del administrador de llamadas que el administrador de llamadas proporcionó a NDIS en la función ProtocolCmOpenAf .

[in] Status

El estado final de los clientes para la notificación de cierre de AF. El estado puede ser uno de los siguientes:

NDIS_STATUS_SUCCESS

El cliente cerró correctamente su familia de direcciones.

NDIS_STATUS_XXX

El cliente produjo un error en la solicitud por algún motivo determinado por el controlador.

Valor devuelto

None

Observaciones

La función ProtocolCmNotifyCloseAfComplete es necesaria para los administradores de llamadas de CoNDIS.

Si un administrador de llamadas independiente se desenlace de un adaptador de miniport subyacente, el administrador de llamadas debe llamar al Función NdisCmNotifyCloseAddressFamily antes de desenlace. Cuando un administrador de llamadas de minipuerto (MCM) detiene un adaptador de minipuerto, el MCM debe llamar al Función NdisMCmNotifyCloseAddressFamily .

Si NdisCmNotifyCloseAddressFamily o NdisMCmNotifyCloseAddressFamily devuelve NDIS_STATUS_PENDING, NDIS llama a ProtocolCmNotifyCloseAfComplete después de que el cliente complete la operación de cierre de AF.

NDIS llama a ProtocolCmNotifyCloseAfComplete en IRQL <= DISPATCH_LEVEL.

Ejemplos

Para definir una función ProtocolCmNotifyCloseAfComplete , primero debe proporcionar una declaración de función que identifique el tipo de función que está definiendo. Windows proporciona un conjunto de tipos de función para controladores. Declarar una función mediante los tipos de función ayuda a Code Analysis for Drivers, Static Driver Verifier (SDV) y otras herramientas de comprobación a encontrar errores y es un requisito para escribir controladores para el sistema operativo Windows.

Por ejemplo, para definir una función ProtocolCmNotifyCloseAfComplete denominada "MyCmNotifyCloseAfComplete", use el tipo de PROTOCOL_CM_NOTIFY_CLOSE_AF_COMPLETE como se muestra en este ejemplo de código:

PROTOCOL_CM_NOTIFY_CLOSE_AF_COMPLETE MyCmNotifyCloseAfComplete;

A continuación, implemente la función de la siguiente manera:

_Use_decl_annotations_
VOID
 MyCmNotifyCloseAfComplete(
    NDIS_HANDLE  CallMgrAfContext,
    NDIS_STATUS  Status
    )
  {...}

El tipo de función PROTOCOL_CM_NOTIFY_CLOSE_AF_COMPLETE se define en el archivo de encabezado Ndis.h. Para identificar con más precisión los errores al ejecutar las herramientas de análisis de código, asegúrese de agregar la anotación Use_decl_annotations a la definición de función. La anotación Use_decl_annotations garantiza que se usen las anotaciones que se aplican al tipo de función PROTOCOL_CM_NOTIFY_CLOSE_AF_COMPLETE en el archivo de encabezado. Para obtener más información sobre los requisitos de las declaraciones de función, consulte Declaración de funciones mediante el uso de tipos de roles de función para controladores NDIS.

Para obtener información sobre Use_decl_annotations, consulte Anotación del comportamiento de la función.

Requisitos

Requisito	Value
Cliente mínimo compatible	Se admite en NDIS 6.0 y versiones posteriores.
Plataforma de destino	Windows
Encabezado	ndis.h (incluya Ndis.h)
IRQL	<= DISPATCH_LEVEL

Consulte también

NdisCmNotifyCloseAddressFamily NdisMCmNotifyCloseAddressFamily

ProtocolCmOpenAf