OID_PNP_ENABLE_WAKE_UP

设置后,OID_PNP_ENABLE_WAKE_UP OID 指定微型端口驱动程序应在网络适配器中启用的唤醒功能。

作为查询,OID_PNP_ENABLE_WAKE_UP获取为网络适配器启用的当前唤醒功能。

NDIS_OID_REQUEST 结构的 InformationBuffer 成员是标志的位掩码,可用于启用唤醒事件的组合:

NDIS_PNP_WAKE_UP_MAGIC_PACKET
设置时,指定微型端口驱动程序应启用网络适配器,以便在收到神奇数据包时发出唤醒事件信号。 (神奇数据包 是包含接收网络适配器以太网地址的 16 个连续副本的数据包。清除后,指定微型端口驱动程序应禁用网络适配器发出此类唤醒事件信号。

NDIS_PNP_WAKE_UP_PATTERN_MATCH
设置后,指定微型端口驱动程序应启用网络适配器,以便在收到包含协议指定的模式的数据包时发出唤醒事件信号,该数据包具有 OID_PNP_ADD_WAKE_UP_PATTERN。 清除后,指定微型端口驱动程序应禁用网络适配器发出此类唤醒事件信号。

NDIS_PNP_WAKE_UP_LINK_CHANGE
保留。 NDIS 忽略此标志。

协议驱动程序使用 NDIS_BIND_PARAMETERS 中的网络适配器唤醒功能来启用关联的网络适配器唤醒功能。 协议驱动程序还可以查询此 OID,以确定为网络适配器启用哪些唤醒功能。

NDIS 不会立即启用协议驱动程序指定的唤醒功能。 相反,NDIS 会跟踪协议驱动程序启用的唤醒功能,在网络适配器转换为低功率状态之前,NDIS 会向微型端口驱动程序发送一个OID_PNP_ENABLE_WAKE_UP设置的请求,以启用适当的唤醒事件。

在网络适配器转换为低功率状态(即,在 NDIS 向微型端口驱动程序发送 OID_PNP_SET_POWER 请求之前),NDIS 会向微型端口驱动程序发送一个OID_PNP_ENABLE_WAKE_UP请求,以启用适当的唤醒功能。

微型端口驱动程序必须执行适当的设备相关步骤,才能在网络适配器上启用或禁用唤醒事件。

微型端口驱动程序应清除恢复系统时使用 OID_PNP_ENABLE_WAKE_UP 设置的 NDIS 唤醒功能。 不应在简历中保留唤醒功能。 如果启用了唤醒功能,NDIS 在微型端口转换为低功率状态之前显式设置OID_PNP_ENABLE_WAKE_UP。

上边缘接收此 OID 请求的中间驱动程序必须始终通过调用 NdisOidRequestNdisCoOidRequest 函数将请求传播到基础微型端口驱动程序。

要求

版本

NDIS 6.0 和 6.1 支持。 对于 NDIS 6.20 及更高版本,请改用 OID_PM_PARAMETERS)。

页眉

Ntddndis.h (包括 Ndis.h)

另请参阅

NDIS_BIND_PARAMETERS

NDIS_OID_REQUEST

NdisCoOidRequest

NdisOidRequest

OID_PM_PARAMETERS

OID_PNP_ADD_WAKE_UP_PATTERN