структура 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) |