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

Artículo
02/07/2025

Los clientes NDIS orientados a la conexión usan la función ProtocolClDropPartyComplete que configuran conexiones multipunto. Estos clientes deben tener ProtocolClDropPartyComplete funciones para completar las operaciones asincrónicas que inician con

NdisClDropParty. De lo contrario, tal controlador de protocolo registrado función ProtocolClDropPartyComplete puede simplemente devolver el control.

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

Sintaxis

PROTOCOL_CL_DROP_PARTY_COMPLETE ProtocolClDropPartyComplete;

void ProtocolClDropPartyComplete(
  [in] NDIS_STATUS Status,
  [in] NDIS_HANDLE ProtocolPartyContext
)
{...}

Parámetros

[in] Status

Especifica el estado final de la operación drop-party iniciada por el cliente, que puede ser una de las siguientes:

NDIS_STATUS_SUCCESS

La fiesta ha sido descartada. La NdisPartyHandle que representa a esta entidad, que el cliente almacenado en su área de ProtocolPartyContext, ahora no es válida.

NDIS_STATUS_FAILURE

La entidad especificada fue la última en el vc multipunto del cliente. Por lo tanto, el cliente debe llamar a NdisClCloseCall para quitar esta entidad.

[in] ProtocolPartyContext

Especifica el identificador del área de contexto por entidad del cliente, que el cliente proporcionó originalmente a NDIS cuando llamó a NdisClAddParty o NdisClMakeCall.

Valor devuelto

Ninguno

Observaciones

Una llamada a ProtocolClDropPartyComplete indica que el administrador de llamadas ha completado el procesamiento de la solicitud iniciada por la llamada anterior del cliente a NdisClDropParty. ProtocolClDropPartyComplete puede liberar el área de contexto por parte asignada por el cliente o prepararla para su reutilización en una llamada posterior a NdisClAddParty.

Si el cliente está en proceso de anular un VC de varios puntos que creó, ProtocolClDropPartyComplete puede llamar a NdisClDropParty con cualquier NdisPartyHandle válido a una de las partes restantes de la vc multipoint activa del cliente. Si solo una entidad más permanece en su VC de varios puntos, el cliente debe quitar esa entidad pasando su NdisPartyHandle a NdisClCloseCall.

Ejemplos de

Para definir una función ProtocolClDropPartyComplete, 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 análisis de código para controladores, comprobador de controladores estáticos (SDV) y otras herramientas de comprobación encuentran errores y es un requisito para escribir controladores para el sistema operativo Windows.

Por ejemplo, para definir un ProtocolClDropPartyComplete función denominada "MyClDropPartyComplete", use el tipo PROTOCOL_CL_DROP_PARTY_COMPLETE tal como se muestra en este ejemplo de código:

PROTOCOL_CL_DROP_PARTY_COMPLETE MyClDropPartyComplete;

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

_Use_decl_annotations_
VOID
 MyClDropPartyComplete(
    NDIS_STATUS  Status,
    NDIS_HANDLE  ProtocolPartyContext
    )
  {...}

El tipo de función PROTOCOL_CL_DROP_PARTY_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_CL_DROP_PARTY_COMPLETE en el archivo de encabezado. Para obtener más información sobre los requisitos de las declaraciones de función, vea 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, vea Anotación del comportamiento de la función.

Requisitos

Requisito	Valor
cliente mínimo admitido	Compatible con controladores NDIS 6.0 y NDIS 5.1 (consulte ProtocolClDropPartyComplete (NDIS 5.1)) en Windows Vista. Compatible con controladores NDIS 5.1 (consulte ProtocolClDropPartyComplete (NDIS 5.1)) en Windows XP.
de la plataforma de destino de	Windows
encabezado de	ndis.h (incluya Ndis.h)
irQL	<= DISPATCH_LEVEL