Macro NdisMCmDispatchIncomingDropParty (ndis.h)
NdisMCmDispatchIncomingDropParty avertit un client qu’il doit supprimer un tiers particulier sur un vc multipoint.
Syntaxe
void NdisMCmDispatchIncomingDropParty(
_S_,
_H_,
_B_,
_Z_
);
Paramètres
_S_
Indique la raison pour laquelle cette partie est supprimée, généralement NDIS_STATUS_SUCCESS si la partie distante a simplement demandé que sa connexion soit fermée.
_H_
Spécifie le handle qui identifie la partie à supprimer de la vc multipoint, qui doit avoir d’autres parties qui sont toujours connectées. Le pilote MCM a obtenu à l’origine ce handle en tant que paramètre d’entrée pour sa fonction ProtocolCmAddParty.
_B_
Pointeur vers une mémoire tampon résidente allouée par l’appelant contenant des données supplémentaires spécifiques au protocole reçues du tiers distant, le cas échéant. Selon le support sous-jacent, ce pointeur peut être NULL.
_Z_
Spécifie la taille en octets de la mémoire tampon, zéro si tampon est null.
Valeur de retour
Aucun
Remarques
Au cours des opérations réseau normales, un pilote MCM appelle NdisMCmDispatchIncomingDropParty avec le CloseStatus défini sur NDIS_STATUS_SUCCESS, car un client distant sur une connexion multipoint a appelé NdisClCloseCall.
Toutefois, un pilote MCM peut également appeler NdisMCmDispatchIncomingDropParty avec un CloseStatus déterminé par le pilote au plus près du réseau lui-même si des conditions réseau anormales se produisent, par exemple l’échec d’un commutateur sur le chemin d’accès entre le client local et un ou plusieurs clients sur une connexion multipoint établie.
Un appel à NdisMCmDispatchIncomingDropParty entraîne l’appel de NDIS au client ProtocolClIncomingDropParty fonction.
Si le NdisPartyHandle identifie la dernière partie restante sur la vc donnée, le pilote MCM appelle NdisMCmDispatchIncomingCloseCall, au lieu de NdisMCmDispatchIncomingDropParty.
Seuls les pilotes miniport orientés connexion qui fournissent une prise en charge intégrée de la gestion des appels peuvent appeler NdisMCmDispatchIncomingDropParty. Les gestionnaires d’appels autonomes, qui s’inscrivent auprès de NDIS comme pilotes de protocole, appellent NdispatchIncomingDropParty à la place.