PROTOCOL_CM_INCOMING_CALL_COMPLETE funzione di callback (ndis.h)
È necessaria la funzione ProtocolCmIncomingCallComplete . Quando NDIS chiama questa funzione, ProtocolCmIncomingCallComplete indica alla gestione chiamate che il client orientato alla connessione ha completato l'elaborazione di un'offerta di chiamata in ingresso inviata in precedenza dal gestore chiamate tramite NdisCmDispatchIncomingCall.
Sintassi
PROTOCOL_CM_INCOMING_CALL_COMPLETE ProtocolCmIncomingCallComplete;
void ProtocolCmIncomingCallComplete(
[in] NDIS_STATUS Status,
[in] NDIS_HANDLE CallMgrVcContext,
[in] PCO_CALL_PARAMETERS CallParameters
)
{...}
Parametri
[in] Status
Indica lo stato finale dell'operazione per inviare una chiamata in ingresso a un client orientato alla connessione.
[in] CallMgrVcContext
Specifica l'handle in un'area di contesto allocata dal gestore chiamate in cui il gestore chiamate mantiene lo stato per vc. Il gestore chiamate ha fornito questo handle dalla relativa funzione ProtocolCoCreateVc .
[in] CallParameters
Puntatore ai parametri di chiamata come specificato dal gestore chiamate nella chiamata a NdisCmDispatchIncomingCall. Il protocollo di segnalazione determina quali parametri di chiamata, se presenti, il gestore chiamate può modificare.
Valore restituito
nessuno
Osservazioni
Quando il client orientato alla connessione ha completato l'elaborazione di un'offerta di connessione in ingresso a cui è stato inviato il gestore chiamate, questa routine verrà chiamata se NdisCmDispatchIncomingCall ha restituito NDIS_STATUS_PENDING. Lo stato finale della chiamata in ingresso viene trovato in Stato. I valori possibili per Status includono, ma non sono limitati a:
Se il client accetta la chiamata in ingresso, il gestore chiamate deve inviare messaggi di segnalazione per indicare all'entità chiamante che la chiamata è stata accettata. Se il client non accetta la chiamata, il gestore chiamate deve inviare messaggi di segnalazione per indicare che la chiamata è stata rifiutata.
Esempi
Per definire una funzione ProtocolCmIncomingCallComplete , è prima 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 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 ProtocolCmIncomingCallComplete denominata "MyCmIncomingCallComplete ", usare il tipo di PROTOCOL_CM_INCOMING_CALL_COMPLETE come illustrato in questo esempio di codice:
PROTOCOL_CM_INCOMING_CALL_COMPLETE MyCmIncomingCallComplete;
Implementare quindi la funzione come indicato di seguito:
_Use_decl_annotations_
VOID
MyCmIncomingCallComplete(
NDIS_STATUS Status,
NDIS_HANDLE CallMgrVcContext,
PCO_CALL_PARAMETERS CallParameters
)
{...}
Il tipo di funzione PROTOCOL_CM_INCOMING_CALL_COMPLETE è 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_CM_INCOMING_CALL_COMPLETE 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 ProtocolCmIncomingCallComplete (NDIS 5.1) in Windows Vista. Supportato per i driver NDIS 5.1 (vedere ProtocolCmIncomingCallComplete (NDIS 5.1) in Windows XP. |
| Piattaforma di destinazione | Windows |
| Intestazione | ndis.h (includere Ndis.h) |
| IRQL | <= DISPATCH_LEVEL |