NdisIMCopySendCompletePerPacketInfo, fonction (ndis.h)

  • Article

Note NDIS 5. x a été déprécié 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 vers NDIS 6. x, consultez Portage des pilotes NDIS 5.x vers NDIS 6.0.

NdisIMCopySendCompletePerPacketInfo copie les informations par paquet d’un paquet retourné par un pilote miniport inférieur dans un nouveau paquet qui doit être retourné à un pilote de niveau supérieur.

Syntaxe

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

Paramètres

[out] DstPacket

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

[in] SrcPacket

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

Valeur de retour

None

Remarques

Lorsqu’un pilote intermédiaire gère l’achèvement d’une demande d’envoi à partir d’un pilote miniport inférieur, ce pilote intermédiaire appelle NdisIMCopySendCompletePerPacketInfo pour copier les informations par paquet. Le pilote intermédiaire copie les informations par paquet d’un paquet retourné par le pilote miniport inférieur dans un nouveau paquet que le pilote intermédiaire retourne à un pilote de niveau supérieur. Le pilote intermédiaire appelle NdisIMCopySendCompletePerPacketInfo pour chaque paquet retourné 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 auxquelles 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 doit 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 à 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