Fonction NdisGeneratePartialCancelId (ndis.h)

  • Article

La fonction NdisGeneratePartialCancelId retourne une valeur que le pilote appelant doit utiliser comme octet d’ordre élevé d’un ID d’annulation.

Syntaxe

UCHAR NdisGeneratePartialCancelId();

Valeur de retour

NdisGeneratePartialCancelId retourne une valeur que le pilote appelant utilise comme octet d’ordre élevé d’un ID d’annulation.

Remarques

Avant de marquer les structures d’envoi NET_BUFFER_LIST avec des ID d’annulation, en appelant le NDIS_SET_NET_BUFFER_LIST_CANCEL_ID macro, un pilote doit appeler NdisGeneratePartialCancelId une ou plusieurs fois. NdisGeneratePartialCancelId retourne une valeur que le pilote appelant peut utiliser comme octet d’ordre élevé d’un ID d’annulation. Le préfixe d’un ID d’annulation avec la valeur retournée par NdisGeneratePartialCancelId garantit que l’ID d’annulation ne sera pas un doublon d’un ID d’annulation attribué par un autre pilote sur l’ordinateur local.

En règle générale, un pilote qui se superpose appelle NdisGeneratePartialCancelId une ou plusieurs fois pendant sa séquence d’initialisation et stocke la ou les valeurs retournées pour une utilisation ultérieure. Un pilote de protocole, par exemple, peut appeler NdisGeneratePartialCancelId une fois pour chaque client (par exemple, DHCP ou ARC) qu’il prend en charge. Le pilote de protocole peut appeler le NdisCancelSendNetBufferLists fonctionne ultérieurement pour annuler une demande d’envoi. Dans ce cas, NDIS appelle la fonction d’envoi cancel (par exemple, MiniportCancelSend) des pilotes sous-jacents.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Pris en charge pour les pilotes NDIS 6.0 et NDIS 5.1 (voir NdisGeneratePartialCancelId (NDIS 5.1)) dans Windows Vista. Pris en charge pour les pilotes NDIS 5.1 (consultez NdisGeneratePartialCancelId (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_Miscellaneous_Function(ndis)

Voir aussi

MiniportCancelSend

NDIS_SET_NET_BUFFER_LIST_CANCEL_ID

NET_BUFFER_LIST

NdisCancelSendNetBufferLists