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

Статья
02/26/2024

Структура NDIS_RESTART_ATTRIBUTES определяет запись атрибутов в связанном списке атрибутов перезапуска.

Синтаксис

typedef struct _NDIS_RESTART_ATTRIBUTES {
  PNDIS_RESTART_ATTRIBUTES Next;
  NDIS_OID                 Oid;
  ULONG                    DataLength;
  UCHAR                    Data[1];
} NDIS_RESTART_ATTRIBUTES, *PNDIS_RESTART_ATTRIBUTES;

Члены

Next

Указатель на структуру NDIS_RESTART_ATTRIBUTES, которую можно использовать для доступа к следующему набору атрибутов перезапуска в связанном списке атрибутов. Если дополнительные атрибуты отсутствуют, этот элемент имеет значение NULL.

Oid

Идентификатор объекта NDIS для сведений, которые содержатся в элементе Data . Например, если Oid имеет значение OID_GEN_MINIPORT_RESTART_ATTRIBUTES элемент Data содержит структура NDIS_RESTART_GENERAL_ATTRIBUTES .

DataLength

Длина (в байтах) сведений, хранящихся в элементе Data .

Data[1]

Буфер, содержащий сведения, связанные с OID, указанным в элементе Oid .

При вызове функции MiniportRestart драйвера минипорта NDIS передает указатель на структуру NDIS_RESTART_ATTRIBUTES драйверу мини-порта в элементе RestartAttributes NDIS_MINIPORT_RESTART_PARAMETERS структура.

При вызове функции FilterRestart драйвера фильтра NDIS передает указатель на структуру NDIS_RESTART_ATTRIBUTES драйверу фильтра в элементе RestartAttributes структура NDIS_FILTER_RESTART_PARAMETERS .

При перезапуске привязки протокола NDIS предоставляет указатель на структуру NDIS_RESTART_ATTRIBUTES в элементе RestartAttributes NDIS_PROTOCOL_RESTART_PARAMETERS структура. Чтобы перезапустить привязку протокола, NDIS вызывает функцию ProtocolNetPnPEvent драйвера протокола. Элемент NetPnPEvent NET_PNP_EVENT_NOTIFICATION структура, которую NDIS передает в ProtocolNetPnPEvent, содержит NET_PNP_EVENT структуру. Структура NET_PNP_EVENT указывает NetEventRestart в элементе NetEvent и указатель на структуру NDIS_PROTOCOL_RESTART_PARAMETERS в элементе Buffer .

Если указатель атрибутов перезапуска, который NDIS передает драйверам NDIS, имеет значение NULL, драйверы не должны распространять свои изменения атрибутов в стеке драйверов. В этом случае драйверы не должны изменять или сообщать об изменениях атрибутов.

Если указатель атрибутов перезапуска не имеет значения NULL, связанный список NDIS_RESTART_ATTRIBUTES структур содержит по крайней мере одну запись, содержащую структура NDIS_RESTART_GENERAL_ATTRIBUTES . Остальные записи, если таковые есть, содержат атрибуты мультимедиа.

Требования

Требование	Значение
Минимальная версия клиента	Поддерживается в NDIS 6.0 и более поздних версиях.
Верхняя часть	ndis.h (включая Ndis.h)