structure NDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX (ndis.h)

Article
02/07/2025

La structure NDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX définit des informations spécifiques aux médias associées à une structure NET_BUFFER_LIST.

Syntaxe

typedef struct _NDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX {
  NDIS_OBJECT_HEADER                             Header;
  struct _NDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX *NextEntry;
  ULONG                                          Tag;
  PVOID                                          Data;
} NDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX, *PNDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX;

Membres

Header

Structure NDIS_OBJECT_HEADER de la structure (NDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX). Le pilote définit le membre type de la structure spécifiée par Header sur NDIS_OBJECT_TYPE_DEFAULT, le membre Revision sur NDIS_NBL_MEDIA_SPECIFIC_INFO_REVISION_1 et le membre Size sur NDIS_SIZEOF_NBL_MEDIA_SPECIFIC_INFO_REVISION_1.

NextEntry

Pointeur vers la structure de NDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX suivante dans une liste liée de structures NDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX. S’il s’agit de la dernière structure de la liste, le pointeur est NULL . Les pilotes doivent utiliser le NDIS_NBL_ADD_MEDIA_SPECIFIC_INFO_EX, NDIS_NBL_GET_MEDIA_SPECIFIC_INFO_EX, et NDIS_NBL_REMOVE_MEDIA_SPECIFIC_INFO_EX macros pour manipuler cette liste.

Tag

Valeur unique (attribuée par Microsoft) qui identifie le type d’informations spécifiques aux médias. Ce membre est réservé à l’utilisation du système.

De nouvelles balises peuvent être affectées dans les futures versions système pour les nouveaux types de supports qui nécessitent des données OOB supplémentaires spécifiques à un type de média particulier.

Data

Pointeur vers une mémoire tampon qui contient les informations spécifiques au média.

Remarques

Les pilotes NDIS 6.20 et versions ultérieures doivent utiliser la structure NDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX pour spécifier des informations spécifiques au support. Tout pilote d’une pile de pilotes NDIS peut allouer et gérer des informations spécifiques aux médias. Les informations spécifiques aux médias sont spécifiées dans une liste liée terminée par NULL de structures NDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX, et chaque structure contient des données allouées par le pilote et définies par le pilote.

Les structures de la liste contiennent toutes les données OOB spécifiques au support qui accompagnent les structures NET_BUFFER associées à une structure NET_BUFFER_LIST.

Si un pilote de protocole a alloué les données OOB, il a configuré les données pour une opération d’envoi. Si un pilote miniport a alloué les données, il a configuré les données pour une indication de réception.

Pour obtenir le premier élément de la liste liée, un pilote NDIS appelle la macro NET_BUFFER_LIST_INFO et spécifie le type d’informations MediaSpecificInformationEx.

Pour ajouter, obtenir et supprimer des structures NDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX dans la liste liée, utilisez la NDIS_NBL_ADD_MEDIA_SPECIFIC_INFO_EX, NDIS_NBL_GET_MEDIA_SPECIFIC_INFO_EX, et NDIS_NBL_REMOVE_MEDIA_SPECIFIC_INFO_EX macros.