NdisGeneratePartialCancelId, fonction (ndis.h)
La fonction NdisGeneratePartialCancelId retourne une valeur que le pilote appelant doit utiliser comme octet de commande élevée d’un ID d’annulation.
Syntaxe
UCHAR NdisGeneratePartialCancelId();
Valeur de retour
NdisGeneratePartialCancelId retourne une valeur que le pilote appelant utilise comme octet de commande élevée 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 de commande élevée 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 dupliqué d’un ID d’annulation affecté par un autre pilote de l’ordinateur local.
En règle générale, un pilote overlying appelle NdisGeneratePartialCancelId une ou plusieurs fois pendant sa séquence d’initialisation et stocke la valeur ou les valeurs retournées pour une utilisation ultérieure. Par exemple, un pilote de protocole peut appeler NdisGeneratePartialCancelId une fois pour chaque client (tel que DHCP ou ARC) qu’il prend en charge. Le pilote de protocole peut appeler le NdisCancelSendNetBufferLists fonction ultérieurement pour annuler une demande d’envoi. Dans ce cas, NDIS appelle la fonction d’envoi d’annulation (par exemple, MiniportCancelSend) des pilotes sous-jacents.