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

  • Статья

Структура NDIS_PROTOCOL_RESTART_PARAMETERS определяет параметры перезапуска для драйвера протокола, когда NDIS вызывает функцию ProtocolNetPnPEvent для указания события NetEventRestart .

Синтаксис

typedef struct _NDIS_PROTOCOL_RESTART_PARAMETERS {
  NDIS_OBJECT_HEADER       Header;
  PUCHAR                   FilterModuleNameBuffer;
  ULONG                    FilterModuleNameBufferLength;
  PNDIS_RESTART_ATTRIBUTES RestartAttributes;
  NET_IFINDEX              BoundIfIndex;
  NET_LUID                 BoundIfNetluid;
  ULONG                    Flags;
} NDIS_PROTOCOL_RESTART_PARAMETERS, *PNDIS_PROTOCOL_RESTART_PARAMETERS;

Члены

Header

Структура NDIS_OBJECT_HEADER для структуры NDIS_PROTOCOL_RESTART_PARAMETERS. NDIS задает для элемента Type структуры, указанной в заголовке , значение NDIS_OBJECT_TYPE_PROTOCOL_RESTART_PARAMETERS, для элемента Revision — NDIS_PROTOCOL_RESTART_PARAMETERS_REVISION_1, а для элемента Size — значение NDIS_SIZEOF_PROTOCOL_RESTART_PARAMETERS_REVISION_1.

FilterModuleNameBuffer

Список имен базовых модулей фильтра. Для каждого имени буфер содержит значение USHORT, за которым следует строка расширенных символов. Используйте первое значение USHORT в буфере, чтобы определить длину первой строки. Используйте длину первой строки, чтобы определить начало следующей строки. Продолжайте так, чтобы число байтов, полученных из буфера, не сравнялось с числом байтов, указанных в элементе FilterModuleNameBufferLength .

FilterModuleNameBufferLength

Длина буфера в байтах в элементе FilterModuleNameBuffer .

RestartAttributes

Указатель на первую запись в списке NDIS_RESTART_ATTRIBUTES структур. Используйте элемент Next структуры NDIS_RESTART_ATTRIBUTES, чтобы получить следующую структуру в списке.

BoundIfIndex

Индекс сетевого интерфейса NDIS интерфейса самого высокого уровня, который размещен на адаптере мини-порта. Это значит, что при наличии виртуальных минипортов или модулей фильтров, установленных через адаптер минипорта, этот член является ifIndex модуля самого высокого уровня виртуального минипорта или фильтра.

BoundIfNetluid

Значение NET_LUID NDIS (также имя сетевого интерфейса (ifName в RFC 2863)) интерфейса самого высокого уровня, размещенного на адаптере мини-порта. То есть при наличии виртуальных минипортов или модулей фильтров, установленных через адаптер минипорта, этот элемент является NET_LUID значением виртуального мини-порта или фильтра самого высокого уровня.

Flags

Зарезервировано для последующего использования.

Комментарии

NDIS передает структуру NDIS_PROTOCOL_RESTART_PARAMETERS драйверу протокола при вызове функции ProtocolNetPnPEvent для указания события NetEventRestart .

Каждое имя, указанное в буфере в элементе FilterModuleNameBuffer , не гарантируется завершением null. Значение USHORT в начале каждой строки содержит длину строки в байтах. Драйверы протокола должны проверка значение члена FilterModuleNameBufferLength перед доступом к буферу.

Требования

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

См. также раздел

NDIS_OBJECT_HEADER

NDIS_RESTART_ATTRIBUTES

ProtocolNetPnPEvent