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请求以启用相应的唤醒功能。

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

系统恢复时,微型端口驱动程序应清除 NDIS 使用 OID_PNP_ENABLE_WAKE_UP 设置的唤醒功能。 不应在简历中保留唤醒功能。 如果启用了唤醒功能,则在微型端口转换为低功耗状态之前,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