Fonction NdisGeneratePartialCancelId (ndis.h)
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) |