Macro NdisMCmAddPartyComplete (ndis.h)
NdisMCmAddPartyComplete restituisce lo stato finale della richiesta di un client, per cui il driver MCM restituito in precedenza NDIS_STATUS_PENDING, per aggiungere una parte in un vc multipoint stabilito.
Sintassi
void NdisMCmAddPartyComplete(
_S_,
_H_,
_C_,
_P_
);
Parametri
_S_
Specifica lo stato finale dell'operazione di aggiunta del driver MCM, NDIS_STATUS_SUCCESS o qualsiasi NDIS_STATUS_XXXad eccezione di NDIS_STATUS_PENDING.
_H_
Specifica l'handle che identifica l'entità. Il driver MCM ha ottenuto questo handle come parametro di input per la relativa funzione ProtocolCmAddParty.
_C_
Specifica l'handle a un'area di contesto residente allocata dal chiamante in cui il driver MCM manterrà informazioni sullo stato specifiche dell'entità se l'operazione di aggiunta è riuscita. In caso contrario, questo parametro può essere null perché viene ignorato da NDIS se Status è diverso da NDIS_STATUS_SUCCESS.
_P_
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 di ProtocolCmAddParty di un driver MCM restituisce NDIS_STATUS_PENDING, il driver deve chiamare NdisMCmAddPartyComplete successivamente per notificare al client e NDIS che il tentativo di aggiungere una parte nel vc multipoint è stato completato, sia correttamente che con uno stato di errore determinato dal driver MCM.
Il supporto di rete sottostante determina se un client può specificare parametri di traffico per parti in un vc multipunto.
Se il supporto di rete sottostante non supporta i parametri di traffico per parti in VC multipoint, un driver MCM può eseguire una delle operazioni seguenti ogni volta che un client tenta di aggiungere una parte con una specifica in CallParameters che non corrisponde ai parametri di traffico già stabiliti per tale vc:
- Reimpostare i parametri di traffico a quelli già stabiliti per il vc multipoint quando aggiunge correttamente la parte in tale vco.
- Modificare i parametri del traffico per ogni parte già presente nel vc quando aggiunge correttamente la nuova entità.
- Rifiutare la richiesta di aggiungere una nuova 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.
Una chiamata a NdisMCmAddPartyComplete fa sì che NDIS chiami il client funzione ProtocolClAddPartyComplete.
Solo i driver miniport orientati alla connessione che forniscono supporto integrato per la gestione delle chiamate possono chiamare NdisMCmAddPartyComplete. I gestori chiamate autonomi, che si registrano con NDIS come driver di protocollo, chiamano invece NdisCmAddPartyComplete.