structure NDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX (ndis.h)

Article
02/29/2024

La structure NDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX définit des informations spécifiques au média 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 que l’en-tête spécifie 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 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 au média. Ce membre est réservé à l’utilisation du système.

De nouvelles balises peuvent être attribuées dans les versions système futures pour les nouveaux types de médias 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 média. N’importe quel pilote d’une pile de pilotes NDIS peut allouer et gérer des informations spécifiques au média. Les informations spécifiques au média 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 au pilote et définies par le pilote.

Les structures de la liste contiennent toutes les données hors bande (OOB) spécifiques aux médias 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 NDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX structures dans la liste liée, utilisez le NDIS_NBL_ADD_MEDIA_SPECIFIC_INFO_EX, NDIS_NBL_GET_MEDIA_SPECIFIC_INFO_EX, et NDIS_NBL_REMOVE_MEDIA_SPECIFIC_INFO_EX macros.