структура NDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX (ndis.h)

Статья
02/07/2025

Структура NDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX определяет сведения, связанные с структурой NET_BUFFER_LIST.

Синтаксис

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;

Члены

Header

Структура NDIS_OBJECT_HEADER для структуры (NDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX). Драйвер задает элемент типа структуры, заголовка указывает NDIS_OBJECT_TYPE_DEFAULT, элемент редакции NDIS_NBL_MEDIA_SPECIFIC_INFO_REVISION_1 и элемент размера NDIS_SIZEOF_NBL_MEDIA_SPECIFIC_INFO_REVISION_1.

NextEntry

Указатель на следующую NDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX структуру в связанном списке NDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX структур. Если это последняя структура в списке, указатель NULL. Драйверы должны использовать NDIS_NBL_ADD_MEDIA_SPECIFIC_INFO_EX, NDIS_NBL_GET_MEDIA_SPECIFIC_INFO_EXи NDIS_NBL_REMOVE_MEDIA_SPECIFIC_INFO_EX макросы для управления этим списком.

Tag

Уникальное значение (назначаемое корпорацией Майкрософт), определяющее тип сведений, относящихся к носителям. Этот элемент зарезервирован для использования системы.

Новые теги можно назначить в будущих системных выпусках для новых типов носителей, требующих дополнительных данных OOB, относящихся к конкретному типу мультимедиа.

Data

Указатель на буфер, содержащий сведения о носителях.

Замечания

Драйверы NDIS 6.20 и более поздних версий должны использовать структуру NDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX для указания сведений о носителях. Любой драйвер в стеке драйверов NDIS может выделять сведения, относящиеся к носителям, и управлять ими. Сведения, относящиеся к носителю, указываются в связанном списке NDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX структур, завершаемых null, и каждая структура содержит данные, выделенные драйвером и определяемые драйвером.

Структуры в списке содержат все внеполосные данные, сопровождающие NET_BUFFER структуры, связанные с NET_BUFFER_LIST структурой.

Если драйвер протокола выделил данные OOB, он настроит данные для операции отправки. Если мини-драйвер выделил данные, он настроит данные для указания получения.

Чтобы получить первый элемент в связанном списке, драйвер NDIS вызывает макрос NET_BUFFER_LIST_INFO и задает тип сведений MediaSpecificInformationEx.

Чтобы добавить, получить и удалить структуры NDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX в связанном списке, используйте NDIS_NBL_ADD_MEDIA_SPECIFIC_INFO_EX, NDIS_NBL_GET_MEDIA_SPECIFIC_INFO_EXи NDIS_NBL_REMOVE_MEDIA_SPECIFIC_INFO_EX макросы.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Поддерживается в NDIS 6.20 и более поздних версиях.
заголовка	ndis.h (include Ndis.h)