PROTOCOL_CL_INCOMING_CALL_QOS_CHANGE función de devolución de llamada (ndis.h)
Los clientes orientados a la conexión usan la función ProtocolClIncomingCallQoSChange en redes que admiten la calidad de servicio dinámica. Estos clientes deben tener funciones protocolClIncomingCallQoSChange. De lo contrario, tal controlador de protocolo registrado protocolClIncomingCallQoSChange función puede simplemente devolver el control.
Sintaxis
PROTOCOL_CL_INCOMING_CALL_QOS_CHANGE ProtocolClIncomingCallQosChange;
void ProtocolClIncomingCallQosChange(
[in] NDIS_HANDLE ProtocolVcContext,
[in] PCO_CALL_PARAMETERS CallParameters
)
{...}
Parámetros
[in] ProtocolVcContext
Especifica el identificador del área de contexto por VC del cliente para el VC en el que una solicitud para modificar la calidad del servicio ha llegado a través de la red.
[in] CallParameters
Puntero a un búfer, con formato de estructura CO_CALL_PARAMETERS, que contiene la nueva especificación de QoS.
Valor devuelto
Ninguno
Observaciones
Una llamada a ProtocolClIncomingCallQoSChange indica al cliente que un mismo nivel remoto ha solicitado un cambio en la calidad del servicio en esta llamada. La nueva calidad de servicio se describe en CallParameters . El cliente puede aceptar el cambio solicitado simplemente devolviendo el control. De otra manera
ProtocolClIncomingCallQoSChange debe anular la llamada con NdisClCloseCall.
Ejemplos de
Para definir una función ProtocolClIncomingCallQoSChange, 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 ProtocolClIncomingCallQoSChange función denominada "MyClIncomingCallQoSChange", use el tipo PROTOCOL_CL_INCOMING_CALL_QOS_CHANGE tal como se muestra en este ejemplo de código:
PROTOCOL_CL_INCOMING_CALL_QOS_CHANGE MyClIncomingCallQoSChange;
A continuación, implemente la función de la siguiente manera:
_Use_decl_annotations_
VOID
MyClIncomingCallQoSChange(
NDIS_HANDLE ProtocolVcContext,
PCO_CALL_PARAMETERS CallParameters
)
{...}
El tipo de función PROTOCOL_CL_INCOMING_CALL_QOS_CHANGE 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_INCOMING_CALL_QOS_CHANGE 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 ProtocolClIncomingCallQoSChange (NDIS 5.1)) en Windows Vista. Compatible con controladores NDIS 5.1 (consulta ProtocolClIncomingCallQoSChange (NDIS 5.1)) en Windows XP. |
| de la plataforma de destino de | Windows |
| encabezado de | ndis.h (incluya Ndis.h) |
| irQL | <= DISPATCH_LEVEL |