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

Artículo
08/07/2023

La función ProtocolClCallConnected la usan los clientes NDIS orientados a la conexión que aceptan llamadas entrantes. Estos clientes deben tener funciones ProtocolClCallConnected . De lo contrario, la función ProtocolClCallConnected registrada del controlador de protocolo puede simplemente devolver el control.

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

Sintaxis

PROTOCOL_CL_CALL_CONNECTED ProtocolClCallConnected;

void ProtocolClCallConnected(
  [in] NDIS_HANDLE ProtocolVcContext
)
{...}

Parámetros

[in] ProtocolVcContext

Especifica el identificador del cliente para su área de contexto por VC. El cliente devolvió originalmente este identificador a NDIS desde su función ProtocolCoCreateVc .

Valor devuelto

None

Observaciones

Cuando se llama a ProtocolClCallConnected , el administrador de llamadas ha completado correctamente el protocolo de enlace final en una oferta de llamada entrante aceptada previamente por la función ProtocolClIncomingCall del cliente, que ya configuró los parámetros de llamada para esta conexión en ProtocolVcContext .

La llamada a ProtocolClCallConnected indica que ahora se pueden realizar transferencias de datos, tanto entrantes como salientes, en el VC. ProtocolClCallConnected debe asegurarse de que el cliente está listo para realizar o aceptar transferencias en el VC antes de devolver el control.

Ejemplos

Para definir una función ProtocolClCallConnected , primero debe proporcionar una declaración de función que identifique el tipo de función que va a definir. 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 ProtocolClCallConnected denominada "MyClCallConnected", use el tipo PROTOCOL_CL_CALL_CONNECTED como se muestra en este ejemplo de código:

PROTOCOL_CL_CALL_CONNECTED MyClCallConnected;

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

_Use_decl_annotations_
VOID
 MyClCallConnected(
    NDIS_HANDLE  ProtocolVcContext
    )
  {...}

El tipo de función PROTOCOL_CL_CALL_CONNECTED 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_CL_CALL_CONNECTED en el archivo de encabezado. Para obtener más información sobre los requisitos de las declaraciones de función, vea Declarar funciones mediante 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	Compatible con controladores NDIS 6.0 y NDIS 5.1 (consulte ProtocolClCallConnected (NDIS 5.1)) en Windows Vista. Compatible con controladores NDIS 5.1 (consulte ProtocolClCallConnected (NDIS 5.1)) en Windows XP.
Plataforma de destino	Windows
Encabezado	ndis.h (incluya Ndis.h)
IRQL	<= DISPATCH_LEVEL