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 信息缓冲区开头的偏移量(即 InformationBufferNDIS_OID_REQUEST 结构的成员指向的缓冲区的开头)到列表中的下一个 NDIS_PM_WOL_PATTERN 结构的开头。 NextWoLPatternOffset 中 列表中最后一个结构的成员的偏移量为零。
对于除 NextWoLPatternOffset 以外的 NDIS_PM_WOL_PATTERN 结构中的偏移量(例如,NameBufferOffset),NDIS 提供了相对于每个 NDIS_PM_WOL_PATTERN 结构的开头的偏移量。
如果没有在网络适配器上设置的 WOL 模式,NDIS 将设置 数据。QUERY_INFORMATION。bytesWrittenNDIS_OID_REQUEST 结构的成员设置为零,并返回请求的 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) |