struttura NDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX (ndis.h)

Articolo
08/07/2023

La struttura NDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX definisce informazioni specifiche del supporto associate a una struttura NET_BUFFER_LIST .

Sintassi

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;

Members

Header

Struttura NDIS_OBJECT_HEADER per la struttura (NDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX). Il driver imposta il membro Type della struttura specificata da Header su NDIS_OBJECT_TYPE_DEFAULT, il membro Revision su NDIS_NBL_MEDIA_SPECIFIC_INFO_REVISION_1 e il membro Size su NDIS_SIZEOF_NBL_MEDIA_SPECIFIC_INFO_REVISION_1.

NextEntry

Puntatore alla struttura NDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX successiva in un elenco collegato di strutture NDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX. Se si tratta dell'ultima struttura nell'elenco, il puntatore è NULL. I driver devono usare il NDIS_NBL_ADD_MEDIA_SPECIFIC_INFO_EX, NDIS_NBL_GET_MEDIA_SPECIFIC_INFO_EX e NDIS_NBL_REMOVE_MEDIA_SPECIFIC_INFO_EX macro per modificare l'elenco.

Tag

Valore univoco (assegnato da Microsoft) che identifica il tipo di informazioni specifiche del supporto. Questo membro è riservato per l'uso del sistema.

I nuovi tag possono essere assegnati nelle versioni future del sistema per i nuovi tipi di supporti che richiedono dati OOB aggiuntivi specifici di un particolare tipo di supporto.

Data

Puntatore a un buffer contenente le informazioni specifiche del supporto.

Commenti

I driver NDIS 6.20 e versioni successive devono usare la struttura NDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX per specificare informazioni specifiche del supporto. Qualsiasi driver in uno stack di driver NDIS può allocare e gestire informazioni specifiche del supporto. Le informazioni specifiche dei supporti vengono specificate in un elenco collegato con terminazione NULL di strutture NDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX e ogni struttura contiene dati allocati dal driver e definiti dal driver.

Le strutture nell'elenco contengono qualsiasi dato OOB (Media Specific Out Of Band) che accompagna le strutture NET_BUFFER associate a una struttura NET_BUFFER_LIST .

Se un driver di protocollo ha allocato i dati OOB, ha configurato i dati per un'operazione di invio. Se un driver miniport ha allocato i dati, ha configurato i dati per un'indicazione di ricezione.

Per ottenere il primo elemento nell'elenco collegato, un driver NDIS chiama la macro NET_BUFFER_LIST_INFO e specifica il tipo di informazioni MediaSpecificInformationEx .

Per aggiungere, ottenere e rimuovere NDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX strutture nell'elenco collegato, usare NDIS_NBL_ADD_MEDIA_SPECIFIC_INFO_EX, NDIS_NBL_GET_MEDIA_SPECIFIC_INFO_EX e NDIS_NBL_REMOVE_MEDIA_SPECIFIC_INFO_EX macro.