PROTOCOL_CL_CALL_CONNECTED funzione di callback (ndis.h)

Articolo
08/07/2023

La funzione ProtocolClCallConnected viene usata dai client NDIS orientati alla connessione che accettano chiamate in ingresso. Tali client devono avere funzioni ProtocolClCallConnected . In caso contrario, la funzione ProtocolClCallConnected registrata di un driver di protocollo di questo tipo può semplicemente restituire il controllo.

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

Sintassi

PROTOCOL_CL_CALL_CONNECTED ProtocolClCallConnected;

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

Parametri

[in] ProtocolVcContext

Specifica l'handle del client nell'area di contesto per vc. Il client ha originariamente restituito questo handle a NDIS dalla relativa funzione ProtocolCoCreateVc .

Valore restituito

nessuno

Osservazioni

Quando viene chiamato ProtocolClCallConnected , il gestore chiamate ha completato correttamente l'handshake finale su un'offerta di chiamata in ingresso accettata in precedenza dalla funzione ProtocolClIncomingCall del client, che ha già configurato i parametri di chiamata per questa connessione in ProtocolVcContext .

La chiamata a ProtocolClCallConnected indica che i trasferimenti di dati, in ingresso o in uscita, ora possono essere eseguiti nel vc. ProtocolClCallConnected deve assicurarsi che il client sia pronto per effettuare o accettare trasferimenti nel vc prima di restituire il controllo.

Esempi

Per definire una funzione ProtocolClCallConnected , è innanzitutto necessario fornire 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 con i tipi di funzione consente di eseguire l'analisi del codice per i driver, l'SDV ( Static Driver Verifier ) e altri strumenti di verifica rilevano gli errori ed è un requisito per la scrittura dei driver per il sistema operativo Windows.

Ad esempio, per definire una funzione ProtocolClCallConnected denominata "MyClCallConnected ", usare il tipo di PROTOCOL_CL_CALL_CONNECTED come illustrato nell'esempio di codice seguente:

PROTOCOL_CL_CALL_CONNECTED MyClCallConnected;

Implementare quindi la funzione come segue:

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

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

Per informazioni sulle 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 ProtocolClCallConnected (NDIS 5.1)) in Windows Vista. Supportato per i driver NDIS 5.1 (vedere ProtocolClCallConnected (NDIS 5.1)) in Windows XP.
Piattaforma di destinazione	Windows
Intestazione	ndis.h (include Ndis.h)
IRQL	<= DISPATCH_LEVEL