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

Статья
02/29/2024

Структура 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). Драйвер задает элемент Type структуры, в котором заголовок задает значение NDIS_OBJECT_TYPE_DEFAULT, элемент Revision — NDIS_NBL_MEDIA_SPECIFIC_INFO_REVISION_1, а элемент Size — 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 (включая Ndis.h)