Macro NdisMCmDispatchIncomingDropParty (ndis.h)

  • Article

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)

Voir aussi

MiniportInterruptDPC

NdisClDropParty

NdisCmDispatchIncomingDropParty NdisMCmDispatchIncomingCloseCall

ProtocolClIncomingDropParty