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 du vc multipoint, qui doit avoir d’autres parties qui sont toujours connectées. Le pilote MCM a initialement obtenu 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 à l’appelant contenant des données supplémentaires spécifiques au protocole reçues de la partie distante, 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 buffer a la valeur NULL.
Valeur de retour
None
Remarques
Dans le cadre d’opérations réseau normales, un pilote MCM appelle NdisMCmDispatchIncomingDropParty avec 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 à la demande du réseau lui-même si des conditions réseau anormales se produisent, telles que la défaillance d’un commutateur sur le chemin entre le client local et un ou plusieurs clients sur une connexion multipoint établie.
Un appel à NdisMCmDispatchIncomingDropParty amène NDIS à appeler le client Fonction ProtocolClIncomingDropParty .
Si le NdisPartyHandle identifie la dernière partie restante sur le vc donné, le pilote MCM appelle NdisMCmDispatchIncomingCloseCall, plutôt que 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 eux-mêmes auprès de NDIS en tant que pilotes de protocole, appellent plutôt NdisCmDispatchIncomingDropParty .
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Pris en charge pour les pilotes NDIS 6.0 et NDIS 5.1 (voir NdisMCmDispatchIncomingDropParty (NDIS 5.1)) dans Windows Vista. Pris en charge pour les pilotes NDIS 5.1 (voir NdisMCmDispatchIncomingDropParty (NDIS 5.1)) dans Windows XP. |
| Plateforme cible | Desktop (Expérience utilisateur) |
| En-tête | ndis.h (inclure Ndis.h) |
| IRQL | <= DISPATCH_LEVEL |
| Règles de conformité DDI | Irql_MCM_Function(ndis) |