OID_PNP_ADD_WAKE_UP_PATTERN
OID_PNP_ADD_WAKE_UP_PATTERN OID 由协议驱动程序发送到微型端口驱动程序以指定唤醒模式。 唤醒模式及其掩码由 NDIS_PM_PACKET_PATTERN 结构描述。
为微型端口驱动程序启用模式匹配唤醒的协议 (请参阅 OID_PNP_ENABLE_WAKE_UP) 使用OID_PNP_ADD_WAKE_UP_PATTERN来指定唤醒模式。 唤醒模式可以存储在主机内存中或网络适配器上,具体取决于网络适配器的功能。
NDIS_OID_REQUEST 结构的 InformationBuffer 成员包含以下内容:
提供模式及其掩码相关信息的 NDIS_PM_PACKET_PATTERN 结构。
一个掩码,指示应将传入数据包的哪些字节与模式中的相应字节进行比较。 掩码以数据包的第一个字节开头。 掩码紧跟在 InformationBuffer 中的NDIS_PM_PACKET_PATTERN结构之后。 有关此掩码工作原理的详细信息,请参阅 网络设备类电源管理参考规范。
唤醒模式,从 InformationBuffer 的开头开始 PatternOffset 字节。 有关唤醒模式的详细信息,请参阅 网络设备类电源管理参考规范。
微型端口驱动程序可从协议中接受的唤醒模式的数量可能取决于资源的可用性,例如微型端口驱动程序为此类模式分配的主机内存,或网络适配器中的可用存储。 如果微型端口驱动程序由于资源不足而无法添加唤醒模式,微型端口驱动程序将返回 NDIS_STATUS_RESOURCES 以响应OID_PNP_ADD_WAKE_UP_PATTERN。
如果协议驱动程序尝试添加重复模式,微型端口驱动程序应返回 NDIS_STATUS_INVALID_DATA 以响应OID_PNP_ADD_WAKE_UP_PATTERN。
上边缘接收此 OID 请求的中间驱动程序必须始终通过调用 NdisRequest 或 NdisCoRequest 将请求传播到基础微型端口驱动程序。
要求
版本 |
在 NDIS 6.0 和 NDIS 6.1 中受支持。 对于 NDIS 6.20 及更高版本,请改用 OID_PM_ADD_WOL_PATTERN 。 |
标头 |
Ntddndis.h (包括 Ndis.h) |