PROTOCOL_CL_INCOMING_CALL_QOS_CHANGE funzione di callback (ndis.h)

Articolo
02/26/2024

La funzione ProtocolClIncomingCallQoSChange viene usata dai client orientati alla connessione nelle reti che supportano la qualità dinamica del servizio. Tali client devono avere funzioni ProtocolClIncomingCallQoSChange . In caso contrario, tale funzione ProtocolClIncomingCallQoSChange del driver di protocollo può semplicemente restituire il controllo.

Nota È necessario dichiarare la funzione usando il tipo di PROTOCOL_CL_INCOMING_CALL_QOS_CHANGE . Per altre informazioni, vedere la sezione Esempi seguenti.

Sintassi

PROTOCOL_CL_INCOMING_CALL_QOS_CHANGE ProtocolClIncomingCallQosChange;

void ProtocolClIncomingCallQosChange(
  [in] NDIS_HANDLE ProtocolVcContext,
  [in] PCO_CALL_PARAMETERS CallParameters
)
{...}

Parametri

[in] ProtocolVcContext

Specifica l'handle per l'area di contesto per VC del client per il vc in cui una richiesta di modifica della qualità del servizio viene inserita nella rete.

[in] CallParameters

Puntatore a un buffer, formattato come struttura CO_CALL_PARAMETERS , che contiene la nuova specifica QoS.

Valore restituito

nessuno

Osservazioni

Una chiamata a ProtocolClIncomingCallQoSChange indica al client che un peer remoto ha richiesto una modifica della qualità del servizio in questa chiamata. La nuova qualità del servizio è descritta in CallParameters . Il client può accettare la modifica richiesta semplicemente restituendo il controllo. Altrimenti
ProtocolClIncomingCallQoSChange deve rimuovere la chiamata con NdisClCloseCall.

Esempi

Per definire una funzione ProtocolClIncomingCallQoSChange , è prima necessario specificare una dichiarazione di funzione che identifica il tipo di funzione che si sta definendo. Windows fornisce un set di tipi di funzione per i driver. La dichiarazione di una funzione usando i tipi di funzione consente l'analisi del codice per i driver, il verifica driver statico (SDV) e altri strumenti di verifica trovano errori ed è un requisito per la scrittura di driver per il sistema operativo Windows.

Ad esempio, per definire una funzione ProtocolClIncomingCallQoSChange denominata "MyClIncomingCallQoSChange ", usare il tipo PROTOCOL_CL_INCOMING_CALL_QOS_CHANGE come illustrato in questo esempio di codice:

PROTOCOL_CL_INCOMING_CALL_QOS_CHANGE MyClIncomingCallQoSChange;

Implementare quindi la funzione come indicato di seguito:

_Use_decl_annotations_
VOID
 MyClIncomingCallQoSChange(
    NDIS_HANDLE  ProtocolVcContext,
    PCO_CALL_PARAMETERS  CallParameters
    )
  {...}

Il tipo di funzione PROTOCOL_CL_INCOMING_CALL_QOS_CHANGE è definito nel file di intestazione Ndis.h. Per identificare in modo più accurato gli errori durante l'esecuzione degli strumenti di analisi del codice, assicurarsi di aggiungere l'annotazione Use_decl_annotations alla definizione della funzione. L'annotazione Use_decl_annotations garantisce che vengano usate le annotazioni applicate al tipo di funzione PROTOCOL_CL_INCOMING_CALL_QOS_CHANGE nel file di intestazione. Per altre informazioni sui requisiti per le dichiarazioni di funzione, vedere Dichiarazione di funzioni tramite tipi di ruolo per i driver NDIS.

Per informazioni su Use_decl_annotations, vedere Annotazione del comportamento della funzione.

Requisiti

Requisito	Valore
Client minimo supportato	Supportato per i driver NDIS 6.0 e NDIS 5.1 (vedere ProtocolClIncomingCallQoSChange (NDIS 5.1) in Windows Vista. Supportato per i driver NDIS 5.1 (vedere ProtocolClIncomingCallQoSChange (NDIS 5.1) in Windows XP.
Piattaforma di destinazione	Windows
Intestazione	ndis.h (includere Ndis.h)
IRQL	<= DISPATCH_LEVEL

Vedi anche

NdisClCloseCall

NdisClModifyCallQoS

ProtocolCmModifyCallQoS

Condividi tramite