Funzione NdisCmAddPartyComplete (ndis.h)
NdisCmAddPartyComplete restituisce lo stato finale della richiesta di un client, per cui il gestore chiamate ha restituito in precedenza NDIS_STATUS_PENDING, per aggiungere una parte in un vc multipoint stabilito.
Sintassi
void NdisCmAddPartyComplete(
[in] NDIS_STATUS Status,
[in] NDIS_HANDLE NdisPartyHandle,
[in, optional] NDIS_HANDLE CallMgrPartyContext,
[in] PCO_CALL_PARAMETERS CallParameters
);
Parametri
[in] Status
Specifica lo stato finale dell'operazione di componente aggiuntivo del gestore chiamate, NDIS_STATUS_SUCCESS o qualsiasi NDIS_STATUS_XXX ad eccezione di NDIS_STATUS_PENDING.
[in] NdisPartyHandle
Specifica l'handle che identifica l'entità. Questo handle è stato input per la funzione di protocolcmaddparty del gestore chiamate.
[in, optional] CallMgrPartyContext
Specifica l'handle di un'area di contesto residente allocata dal chiamante in cui il gestore chiamate manterrà informazioni sullo stato specifiche delle parti se l'operazione di aggiunta ha avuto esito positivo. In caso contrario, questo parametro può essere null perché viene ignorato.
[in] CallParameters
Puntatore a una struttura di tipo CO_CALL_PARAMETERS che contiene i parametri di chiamata, originariamente forniti dal client, affinché l'entità venga aggiunta.
Valore restituito
Nessuno
Osservazioni
Se la funzione ProtocolCmAddParty di un gestore chiamate autonomo restituisce NDIS_STATUS_PENDING, cm deve chiamare successivamente NdisCmAddPartyComplete per notificare al client e NDIS che il tentativo di aggiungere una parte nel vc multipunto è stato completato, sia correttamente che con un errore.
Se il client ha passato parametri di traffico in CallParameters che non corrispondono a quelli già stabiliti per il vc multipoint, la finestra di progettazione del gestore chiamate deve determinare come gestire questa condizione, soggetto a eventuali vincoli imposti dal supporto di rete. Le possibilità includono quanto segue:
- Configurare i parametri di traffico per entità se il supporto di rete sottostante supporta questa funzionalità nei computer virtuali multipoint.
- Reimpostare i parametri di traffico forniti dal client a quelli stabiliti per il vc quando è stata effettuata la chiamata in uscita originale prima delle chiamate CM NdisCmAddPartyComplete con NDIS_STATUS_SUCCESS come stato .
- Modificare i parametri di traffico per vc e, per ogni parte attualmente connessa, ai valori forniti dal client prima che il cm chiami NdisCmAddPartyComplete con NDIS_STATUS_SUCCESS come Stato .
- Non riuscire il tentativo del client di aggiungere un'entità. Questa alternativa forza implicitamente i client a configurare i parametri di traffico per un vc multipoint con NdisClMakeCall e specificare gli stessi parametri di traffico in ogni chiamata successiva a NdisClAddParty per il vc multipoint specificato.
Se cm imposta status su NDIS_STATUS_SUCCESS, deve fornire un handle esplicito, che in genere è un puntatore all'area di stato allocata dal cmm, come CallMgrPartyContext quando chiama NdisCmAddPartyComplete.
Una chiamata a NdisCmAddPartyComplete fa sì che NDIS chiami il client funzione ProtocolClAddPartyComplete.
Solo i gestori chiamate autonomi, che si registrano con NDIS come driver di protocollo, possono chiamare NdisCmAddPartyComplete. Driver miniport orientati alla connessione che forniscono invece una chiamata integrata di gestione delle chiamate NdisMCmAddPartyComplete.