NDIS_RESTART_ATTRIBUTES结构（ndis.h）

项目
02/07/2025

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 对象标识符。例如，如果 Oid 为 OID_GEN_MINIPORT_RESTART_ATTRIBUTES，数据成员包含 NDIS_RESTART_GENERAL_ATTRIBUTES 结构。

DataLength

存储在数据成员中的信息长度（以字节为单位）。

Data[1]

一个缓冲区，其中包含与在 Oid 成员中指定的 OID 关联的信息。

言论

当 NDIS 重启驱动程序堆栈时，NDIS 会将指向指向重启属性的链接列表的指针传递给微型端口、筛选器和协议驱动程序。

当它调用微型端口驱动程序的 MiniportRestart 函数时，NDIS 会将指向NDIS_RESTART_ATTRIBUTES结构的指针传递给 RestartAttributes 成员中的微型端口驱动程序 NDIS_MINIPORT_RESTART_PARAMETERS 结构。

当它调用筛选器驱动程序的 FilterRestart 函数时，NDIS 会将指向NDIS_RESTART_ATTRIBUTES结构的指针传递给 RestartAttributes 成员中的筛选器驱动程序 NDIS_FILTER_RESTART_PARAMETERS 结构。

重启协议绑定时，NDIS 提供指向 RestartAttributes 成员中的NDIS_RESTART_ATTRIBUTES结构的指针 NDIS_PROTOCOL_RESTART_PARAMETERS 结构。若要重启协议绑定，NDIS 调用协议驱动程序的 ProtocolNetPnPEvent 函数。 NetPnPEvent 成员 NET_PNP_EVENT_NOTIFICATION 结构，NDIS 传递给 ProtocolNetPnPEvent，包含 NET_PNP_EVENT 结构。 NET_PNP_EVENT结构指定 NetEvent 成员中的 NetEventRestart，以及指向 Buffer 成员中的NDIS_PROTOCOL_RESTART_PARAMETERS结构的指针。

如果 NDIS 传递给 NDIS 驱动程序的重启属性指针 NULL，则驱动程序不应传播其属性更改驱动程序堆栈。在这种情况下，驱动程序不应修改或报告任何属性更改。

如果重启属性指针未 NULL，则NDIS_RESTART_ATTRIBUTES结构的链接列表至少包含一个条目 NDIS_RESTART_GENERAL_ATTRIBUTES 结构。其余条目（如果有）包含特定于媒体的属性。