OID_PM_PARAMETERS

作为查询,协议驱动程序可以使用 OID_PM_PARAMETERS OID 来查询当前启用的网络适配器的电源管理硬件功能。 成功从 OID 查询请求返回后, NDIS_OID_REQUEST结构的InformationBuffer成员包含指向NDIS_PM_PARAMETERS结构的指针。

作为一个集,协议驱动程序可以使用 OID_PM_PARAMETERS OID 来启用或禁用网络适配器的当前硬件功能。 协议驱动程序在NDIS_OID_REQUEST结构的InformationBuffer成员中提供指向NDIS_PM_PARAMETERS结构的指针。

注解

从 NDIS 6.20 开始,过量协议和筛选器驱动程序使用 OID_PM_PARAMETERS 来查询和设置当前启用的网络适配器的电源管理硬件功能。

当过量驱动程序查询 OID_PM_PARAMETERS OID 时,NDIS 完成请求,而不将其转发给微型端口驱动程序。 NDIS 存储请求的设置,并将它们与其他此类请求中的设置组合在一起。 在 NDIS 将网络适配器转换为低功率状态之前,NDIS 会将 set 请求发送到包含 NDIS 存储的所有请求中的组合设置的微型端口驱动程序。

当前启用的功能可以是硬件支持的功能的子集。 有关硬件支持的功能的详细信息,请参阅 OID_PM_HARDWARE_CAPABILITIES

注意如果 NDIS 在NDIS_PM_PARAMETERS结构的WakeUpFlags成员中设置 NDIS_PM_SELECTIVE_SUSPEND_ENABLED 标志,则它会直接向微型端口驱动程序发出 OID_PM_PARAMETERS 的 OID 集请求。 这允许 NDIS 通过网络驱动程序堆栈中的筛选器驱动程序绕过处理。

NDIS 或微型端口驱动程序为请求返回以下状态代码之一:

NDIS_STATUS_SUCCESS
请求已成功完成。

NDIS_STATUS_PENDING
请求正在等待完成。 请求完成后,NDIS 会将最终状态代码和结果传递给调用方的 OID 请求完成处理程序。

NDIS_STATUS_BUFFER_TOO_SHORT
信息缓冲区太短。 NDIS 设置 数据。QUERY_INFORMATION。 将 NDIS_OID_REQUEST 结构中的成员 BytesNeeded 为所需的最小缓冲区大小。

NDIS_STATUS_INVALID_PARAMETER
请求失败,因为它尝试启用基础网络适配器不支持的功能。

NDIS_STATUS_FAILURE
由于上述原因之外的原因,导致请求失败。

要求

版本

在 NDIS 6.20 和更高版本中受支持。

标头

Ntddndis (包含 Ndis .h)

请参阅

NDIS_OID_REQUEST

NDIS_PM_PARAMETERS

OID_PM_HARDWARE_CAPABILITIES