Fonction NdisIMCopySendPerPacketInfo (ndis.h)

  • Article

Note NDIS 5. x a été déconseillé et est remplacé par NDIS 6. x. Pour le développement de nouveaux pilotes NDIS, consultez Pilotes réseau à partir de Windows Vista. Pour plus d’informations sur le portage de NDIS 5. x pilotes dans NDIS 6. x, consultez Portage des pilotes NDIS 5.x vers NDIS 6.0.

NdisIMCopySendPerPacketInfo copie les informations par paquet d’un paquet qui a été envoyé par un pilote de niveau supérieur dans un nouveau paquet à envoyer à un pilote miniport inférieur.

Syntaxe

void NdisIMCopySendPerPacketInfo(
  [out] OUT PNDIS_PACKET DstPacket,
  [in]  IN PNDIS_PACKET  SrcPacket
);

Paramètres

[out] DstPacket

Pointeur vers le descripteur de paquet de destination dans lequel les informations par paquet doivent être copiées.

[in] SrcPacket

Pointeur vers le descripteur de paquet source à partir duquel les informations par paquet sont copiées.

Valeur de retour

None

Remarques

Lorsqu’un pilote intermédiaire transfère une demande d’envoi d’un pilote de niveau supérieur vers un pilote miniport inférieur, ce pilote intermédiaire appelle NdisIMCopySendPerPacketInfo pour copier les informations par paquet. Le pilote intermédiaire copie les informations par paquet d’un paquet envoyé par le pilote de niveau supérieur dans un nouveau paquet que le pilote intermédiaire envoie au pilote miniport inférieur. Le pilote intermédiaire appelle NdisIMCopySendPerPacketInfo pour chaque paquet envoyé via la pile, sauf si le pilote intermédiaire doit modifier les informations par paquet d’un paquet.

Les informations par paquet sont contenues dans une structure de NDIS_PACKET_EXTENSION et incluent, par exemple, des informations sur la somme de contrôle, des informations sur la sécurité du protocole Internet et des informations de priorité 802.1p.

Si un pilote intermédiaire doit modifier les informations par paquet d’un paquet, ce pilote intermédiaire doit utiliser la macro NDIS_PER_PACKET_INFO_FROM_PACKET pour accéder aux informations. Le pilote peut appeler cette macro une fois pour chaque type d’informations par paquet auquel il doit accéder.

Les pilotes peuvent également utiliser la macro NDIS_PACKET_EXTENSION_FROM_PACKET , qui retourne un pointeur vers la structure NDIS_PACKET_EXTENSION. Un pilote peut appeler cette macro s’il a besoin d’accéder à plusieurs types d’informations par paquet associées à un descripteur de paquets. Après avoir obtenu le pointeur vers la structure NDIS_PACKET_EXTENSION, le pilote peut utiliser l’index de tableau approprié pour obtenir un pointeur vers un type particulier d’informations par paquet.

Pour copier une plage de données d’un paquet vers un autre, utilisez la fonction NdisCopyFromPacketToPacket .

  • Plateforme cible : universelle
  • Version : non pris en charge pour les pilotes NDIS 6.0 dans Windows Vista. Pris en charge pour les pilotes NDIS 5.1 dans Windows Vista et Windows XP.

Configuration requise

Condition requise Valeur
En-tête ndis.h (inclure Ndis.h)
Bibliothèque Ndis.lib
IRQL N’importe quel niveau

Voir aussi