NdisCmDispatchIncomingDropParty, fonction (ndis.h)
NdisCmDispatchIncomingDropParty avertit un client qu’il doit supprimer une partie particulière sur un vc multipoint, généralement parce que le gestionnaire d’appels a reçu une demande sur le réseau pour fermer une connexion multipoint active.
Syntaxe
void NdisCmDispatchIncomingDropParty(
[in] NDIS_STATUS DropStatus,
[in] NDIS_HANDLE NdisPartyHandle,
[in, optional] PVOID Buffer,
[in] UINT Size
);
Paramètres
[in] DropStatus
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.
[in] NdisPartyHandle
Spécifie le handle qui identifie la partie à supprimer du VC multipoint, qui doit avoir d’autres parties qui sont toujours connectées.
[in, optional] Buffer
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 avoir la valeur NULL.
[in] Size
Spécifie la taille en octets de la mémoire tampon, zéro si la mémoire tampon a la valeur NULL.
Valeur de retour
None
Remarques
Dans le cadre d’opérations réseau normales, un gestionnaire d’appels autonome La fonction ProtocolCoReceiveNetBufferLists appelle NdisCmDispatchIncomingDropParty avec closeStatus défini sur NDIS_STATUS_SUCCESS, car un client distant sur une connexion multipoint a appelé NdisClCloseCall.
Toutefois, un gestionnaire d’appels peut également appeler NdisCmDispatchIncomingDropParty avec un CloseStatus déterminé par CM à 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 à NdisCmDispatchIncomingDropParty entraîne l’appel de NDIS du client Fonction ProtocolClIncomingDropParty .
Si le NdisPartyHandle identifie la dernière partie restante sur le VC donné, le CM appelle NdisCmDispatchIncomingCloseCall, plutôt que NdisCmDispatchIncomingDropParty.
Seuls les gestionnaires d’appels autonomes, qui s’inscrivent avec NDIS en tant que pilotes de protocole, peuvent appeler NdisCmDispatchIncomingDropParty. Les pilotes miniports orientés connexion qui fournissent une prise en charge intégrée de la gestion des appels appellent plutôt NdisMCmDispatchIncomingDropParty .
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Pris en charge pour les pilotes NDIS 6.0 et NDIS 5.1 (voir NdisCmDispatchIncomingDropParty (NDIS 5.1)) dans Windows Vista. Pris en charge pour les pilotes NDIS 5.1 (voir NdisCmDispatchIncomingDropParty (NDIS 5.1)) dans Windows XP. |
| Plateforme cible | Desktop (Expérience utilisateur) |
| En-tête | ndis.h (inclure Ndis.h) |
| Bibliothèque | Ndis.lib |
| IRQL | <= DISPATCH_LEVEL |
| Règles de conformité DDI | Irql_CallManager_Function(ndis) |