Macro NdisMCmAddPartyComplete (ndis.h)

Articolo
02/26/2024

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 componente aggiuntivo del driver MCM, NDIS_STATUS_SUCCESS o qualsiasi NDIS_STATUS_XXXtranne 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 di un'area del 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 ProtocolCmAddParty di un driver MCM restituisce NDIS_STATUS_PENDING, il driver deve chiamare NdisMCmAddPartyComplete successivamente per notificare al client e all'NDIS che il tentativo di aggiungere una parte nel vc multipoint è stato completato, indipendentemente dal fatto che lo stato di errore determinato dal driver MCM sia stato corretto o determinato dal driver MCM.

Il supporto di rete sottostante determina se un client può specificare parametri di traffico per entità in un vc multipoint.

Se il supporto di rete sottostante non supporta i parametri di traffico per entità in macchine virtuali 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 del traffico su quelli già stabiliti per vc multipoint quando aggiunge correttamente l'entità in tale vc.
Modificare i parametri di traffico per ogni parte già presente nel vc quando aggiunge correttamente la nuova entità.
Rifiutare la richiesta di aggiungere una nuova entità. Questa alternativa impone implicitamente ai client di configurare i parametri di traffico per un vc multipoint con NdisClMakeCall e di specificare gli stessi parametri di traffico in ogni chiamata successiva a NdisClAddParty per il vc multipoint specificato.

Se il driver MCM imposta Status su NDIS_STATUS_SUCCESS, deve fornire un handle esplicito, che in genere è un puntatore all'area di stato allocata dal driver per parte, come CallMgrPartyContext quando chiama NdisMCmAddPartyComplete.

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 .

Requisiti

Requisito	Valore
Client minimo supportato	Supportato per i driver NDIS 6.0 e NDIS 5.1 (vedere NdisMCmAddPartyComplete (NDIS 5.1)) in Windows Vista. Supportato per i driver NDIS 5.1 (vedere NdisMCmAddPartyComplete (NDIS 5.1)) in Windows XP.
Piattaforma di destinazione	Desktop
Intestazione	ndis.h (include Ndis.h)
IRQL	<= DISPATCH_LEVEL
Regole di conformità DDI	Irql_MCM_Function(ndis)