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 会向微型端口驱动程序发送一个设置请求,该驱动程序包含 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.h (包括 Ndis.h)

另请参阅

NDIS_OID_REQUEST

NDIS_PM_PARAMETERS

OID_PM_HARDWARE_CAPABILITIES