NDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX-Struktur (ndis.h)

Artikel
03/01/2024

Die NDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX-Struktur definiert medienspezifische Informationen, die einer NET_BUFFER_LIST-Struktur zugeordnet sind.

Syntax

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;

Member

Header

Die NDIS_OBJECT_HEADER Struktur für die Struktur (NDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX). Der Treiber legt den Typmember der Struktur, den Header angibt, auf NDIS_OBJECT_TYPE_DEFAULT, das Revisionselement auf NDIS_NBL_MEDIA_SPECIFIC_INFO_REVISION_1 und das Size-Element auf NDIS_SIZEOF_NBL_MEDIA_SPECIFIC_INFO_REVISION_1 fest.

NextEntry

Ein Zeiger auf die nächste NDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX-Struktur in einer verknüpften Liste von NDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX Strukturen. Wenn dies die letzte Struktur in der Liste ist, ist der Zeiger NULL. Treiber müssen die NDIS_NBL_ADD_MEDIA_SPECIFIC_INFO_EX NDIS_NBL_GET_MEDIA_SPECIFIC_INFO_EX und NDIS_NBL_REMOVE_MEDIA_SPECIFIC_INFO_EX Makros, um diese Liste zu bearbeiten.

Tag

Ein eindeutiger Wert (von Microsoft zugewiesen), der den Typ der medienspezifischen Informationen identifiziert. Dieses Element ist für die Systemverwendung reserviert.

Neue Tags können in zukünftigen Systemversionen für neue Medientypen zugewiesen werden, die zusätzliche OOB-Daten erfordern, die für einen bestimmten Medientyp spezifisch sind.

Data

Ein Zeiger auf einen Puffer, der die medienspezifischen Informationen enthält.

Hinweise

NDIS 6.20 und höher sollten die NDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX Struktur verwenden, um medienspezifische Informationen anzugeben. Jeder Treiber in einem NDIS-Treiberstapel kann medienspezifische Informationen zuordnen und verwalten. Die medienspezifischen Informationen werden in einer mit NULL beendeten verknüpften Liste von NDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX-Strukturen angegeben, und jede Struktur enthält vom Treiber zugeordnete und vom Treiber definierte Daten.

Strukturen in der Liste enthalten alle medienspezifischen Out-of-Band-Daten (OOB), die die NET_BUFFER Strukturen begleiten, die einer NET_BUFFER_LIST Struktur zugeordnet sind.

Wenn ein Protokolltreiber die OOB-Daten zugeordnet hat, hat er die Daten für einen Sendevorgang konfiguriert. Wenn ein Miniporttreiber die Daten zugeordnet hat, hat er die Daten für eine Empfangsanzeige konfiguriert.

Um das erste Element in der verknüpften Liste abzurufen, ruft ein NDIS-Treiber das makro NET_BUFFER_LIST_INFO auf und gibt den MediaSpecificInformationEx-Informationstyp an.

Um NDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX Strukturen in der verknüpften Liste hinzuzufügen, abzurufen und zu entfernen, verwenden Sie die NDIS_NBL_ADD_MEDIA_SPECIFIC_INFO_EX NDIS_NBL_GET_MEDIA_SPECIFIC_INFO_EX und NDIS_NBL_REMOVE_MEDIA_SPECIFIC_INFO_EX Makros.