struttura NDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX (ndis.h)

Articolo
02/07/2025

La struttura NDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX definisce informazioni specifiche dei supporti 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;

Membri

Header

Struttura NDIS_OBJECT_HEADER per la struttura (NDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX). Il driver imposta il membro Type della struttura che Header specifica 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 viene NULL. I driver devono usare NDIS_NBL_ADD_MEDIA_SPECIFIC_INFO_EX, NDIS_NBL_GET_MEDIA_SPECIFIC_INFO_EXe 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.

È possibile assegnare nuovi tag 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 che contiene le informazioni specifiche del supporto.

Osservazioni

I driver NDIS 6.20 e versioni successive devono usare la struttura NDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX per specificare informazioni specifiche dei supporti. Qualsiasi driver in uno stack di driver NDIS può allocare e gestire informazioni specifiche dei supporti. 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 tutti i dati OOB (Media-Of-Band) specifici che accompagnano 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_EXe NDIS_NBL_REMOVE_MEDIA_SPECIFIC_INFO_EX macro.