NdisCmDispatchIncomingDropParty, fonction (ndis.h)

  • Article

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)

Voir aussi

NdisClDropParty

NdisCmDispatchIncomingCloseCall NdisMCmDispatchIncomingDropParty

ProtocolClIncomingDropParty

ProtocolCoReceiveNetBufferLists