Notes
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
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 de la 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 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.
[in] Size
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 gestionnaire d’appels autonome ProtocolCoReceiveNetBufferLists appelle NdisCmDispatchIncomingDropParty avec le 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 une CloseStatus déterminée par CM au plus haut niveau du réseau lui-même si des conditions réseau anormales se produisent, telles que 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 à NdisCmDispatchIncomingDropParty entraîne l’appel de NDIS au client ProtocolClIncomingDropParty fonction.
Si le NdisPartyHandle identifie la dernière partie restante sur la vc donnée, la cm appelle NdisCmDispatchIncomingCloseCall, au lieu de NdisCmDispatchIncomingDropParty.
Seuls les gestionnaires d’appels autonomes, qui s’inscrivent auprès de NDIS en tant que pilotes de protocole, peuvent appeler NdisCmDispatchIncomingDropParty. Les pilotes miniport orientés connexion qui fournissent une prise en charge intégrée de la gestion des appels NdisMCmDispatchIncomingDropParty à la place.