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

Data 成员中信息的 NDIS 对象标识符。例如，如果 Oid 为 OID_GEN_MINIPORT_RESTART_ATTRIBUTES，数据成员包含 NDIS_RESTART_GENERAL_ATTRIBUTES 结构。

DataLength

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

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 成员NDIS 传递给 ProtocolNetPnPEvent 的NET_PNP_EVENT_NOTIFICATION结构包含NET_PNP_EVENT结构。 NET_PNP_EVENT 结构指定 NetEvent 成员中的 NetEventRestart 和指向 Buffer 成员中NDIS_PROTOCOL_RESTART_PARAMETERS结构的指针。

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

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