Funzione NdisCmAddPartyComplete (ndis.h)
NdisCmAddPartyComplete restituisce lo stato finale della richiesta di un client, per il quale il chiamante 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 tranne NDIS_STATUS_PENDING .
[in] NdisPartyHandle
Specifica l'handle che identifica la parte. Questo handle è stato input per la funzione ProtocolCmAddParty di Protocol Manager .
[in, optional] CallMgrPartyContext
Specifica l'handle in un'area del contesto residente allocata dal chiamante in cui il gestore chiamate gestirà informazioni sullo stato specifiche delle parti se l'operazione di componente aggiuntivo 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, per l'aggiunta dell'entità.
Valore restituito
nessuno
Osservazioni
Se la funzione ProtocolCmAddParty di un gestore chiamate autonomo restituisce NDIS_STATUS_PENDING, il cm deve successivamente chiamare NdisCmAddPartyComplete per notificare al client e all'NDIS che il relativo tentativo di aggiungere una parte nel vc multipoint è 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. Alcune delle cause possibili sono:
- Configurare i parametri di traffico per parti se il supporto di rete sottostante supporta questa funzionalità in macchine virtuali multipoint.
- Reimpostare i parametri di traffico forniti dal client a quelli stabiliti per il VC quando la chiamata in uscita originale è stata eseguita 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 delle chiamate cm NdisCmAddPartyComplete con NDIS_STATUS_SUCCESS come stato .
- Non riuscire il tentativo del client di aggiungere una parte. In alternativa, i client devono impostare 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 il parametro CM imposta Stato su NDIS_STATUS_SUCCESS, deve fornire un handle esplicito, che in genere è un puntatore all'area di stato allocata da CM per parti, come CallMgrPartyContext quando chiama NdisCmAddPartyComplete.
Una chiamata a NdisCmAddPartyComplete causa la chiamata a NDIS Funzione ProtocolClAddPartyComplete .
Solo i gestori di chiamate autonomi, che si registrano con NDIS come driver di protocollo, possono chiamare NdisCmAddPartyComplete. Driver miniport orientati alla connessione che forniscono invece un supporto integrato per la gestione delle chiamate NdisMCmAddPartyComplete .
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Supportato per i driver NDIS 6.0 e NDIS 5.1 (vedere NdisCmAddPartyComplete (NDIS 5.1) in Windows Vista. Supportato per i driver NDIS 5.1 (vedere NdisCmAddPartyComplete (NDIS 5.1) in Windows XP. |
| Piattaforma di destinazione | Desktop |
| Intestazione | ndis.h (includere Ndis.h) |
| Libreria | Ndis.lib |
| IRQL | <= DISPATCH_LEVEL |
| Regole di conformità DDI | Irql_CallManager_Function(ndis) |