OID_PM_WOL_PATTERN_LIST
作为查询,过度分配驱动程序可以使用 OID_PM_WOL_PATTERN_LIST OID 来枚举在基础网络适配器上设置的 LAN 唤醒模式。 从查询成功返回后,NDIS_OID_REQUEST 结构的 InformationBuffer 成员包含指向描述当前添加的 WOL 模式的NDIS_PM_WOL_PATTERN结构列表的指针。
注解
NDIS 处理微型端口驱动程序的查询。 NDIS 驱动程序可以使用 OID_PM_WOL_PATTERN_LIST OID 获取基础网络适配器上设置的 LAN 模式唤醒列表。
对于列表中的每个NDIS_PM_WOL_PATTERN结构,NDIS 将 NextWoLPatternOffset 成员设置为与 OID 信息缓冲区开头的偏移量 (即,NDIS_OID_REQUEST 结构的 InformationBuffer 成员指向) 到列表中下一个NDIS_PM_WOL_PATTERN结构的开头的缓冲区的开头。 列表中最后一个结构的 NextWoLPatternOffset 成员中的偏移量为零。
对于 除NextWoLPatternOffset (例如 NameBufferOffset) 以外的NDIS_PM_WOL_PATTERN结构中的偏移量,NDIS 提供相对于每个 NDIS_PM_WOL_PATTERN 结构的开头的偏移量。
如果未在网络适配器上设置 WOL 模式,则 NDIS 将设置数据。QUERY_INFORMATION。NDIS_OID_REQUEST 结构的 BytesWritten 成员为零,并返回请求的NDIS_STATUS_SUCCESS。 DATA 中的数据。QUERY_INFORMATION。NDIS 不修改 InformationBuffer 成员。
NDIS 返回请求的以下状态代码之一:
NDIS_STATUS_SUCCESS
请求已成功完成。 InformationBuffer 包含指向 WOL 模式列表(如果有)的指针。
NDIS_STATUS_PENDING
请求正在等待完成。 最终状态代码和结果将传递给调用方 OID 请求完成处理程序。
NDIS_STATUS_BUFFER_TOO_SHORT
信息缓冲区太短。 NDIS 设置 数据。QUERY_INFORMATION。NDIS_OID_REQUEST结构中的 BytesNeeded 成员达到所需的最小缓冲区大小。
NDIS_STATUS_FAILURE
请求因上述原因以外的原因而失败。
要求
版本 |
在 NDIS 6.20 及更高版本中受支持。 对于微型端口驱动程序,未请求。 (请参见“备注”部分。) |
标头 |
Ntddndis.h (包括 Ndis.h) |