macro NDIS_SET_NET_BUFFER_LIST_CANCEL_ID (ndis.h)

Article
03/05/2024

La macro NDIS_SET_NET_BUFFER_LIST_CANCEL_ID marque une structure NET_BUFFER_LIST avec un identificateur d’annulation qu’un pilote peut utiliser ultérieurement pour annuler la transmission en attente des données associées.

Syntaxe

void NDIS_SET_NET_BUFFER_LIST_CANCEL_ID(
   _NBL,
   _CancelId
);

Paramètres

_NBL

Pointeur vers une structure NET_BUFFER_LIST .

_CancelId

Valeur ULONG qui est un identificateur d’annulation pour la structure NET_BUFFER_LIST .

Valeur de retour

None

Remarques

Un pilote NDIS peut appeler la macro NDIS_SET_NET_BUFFER_LIST_CANCEL_ID pour chaque structure NET_BUFFER_LIST qu’il transmet aux pilotes de niveau inférieur pour la transmission. La macro NDIS_SET_NET_BUFFER_LIST_CANCEL_ID marque la structure NET_BUFFER_LIST spécifiée avec un identificateur d’annulation. Les pilotes doivent appeler la fonction NdisGeneratePartialCancelId pour obtenir une valeur que le pilote doit utiliser comme octet d’ordre élevé d’un identificateur d’annulation.

Pour annuler les demandes d’envoi, les pilotes de filtre appellent la fonction NdisFCancelSendNetBufferLists . D’autres pilotes appellent la fonction NdisCancelSendNetBufferLists .

Les pilotes peuvent appeler la macro NDIS_GET_NET_BUFFER_LIST_CANCEL_ID pour récupérer un identificateur d’annulation à partir d’une structure NET_BUFFER_LIST .