OID_PM_GET_PROTOCOL_OFFLOAD

超载驱动程序发出OID_PM_GET_PROTOCOL_OFFLOAD的 OID 方法请求,以获取用于从网络适配器进行低功耗协议卸载的参数设置。

NDIS_OID_REQUEST 结构的 InformationBuffer 成员最初包含指向 ULONG 协议卸载标识符的指针。 从 OID 方法请求成功返回后,NDIS_OID_REQUEST 结构的 InformationBuffer 成员包含指向 NDIS_PM_PROTOCOL_OFFLOAD 结构的指针。

注解

NDIS 6.20 及更高版本的协议驱动程序使用 OID_PM_GET_PROTOCOL_OFFLOAD 方法 OID 从网络适配器检索低功率协议卸载的参数设置。

信息缓冲区必须指向 ULONG 类型的协议卸载标识符。 当 NDIS 将以前的 OID_PM_ADD_PROTOCOL_OFFLOAD OID 请求发送到基础网络适配器时,NDIS 在 NDIS_PM_PROTOCOL_OFFLOAD 结构的 ProtocolOffloadId 成员中设置此协议卸载标识符。

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

NDIS_STATUS_SUCCESS
已成功检索请求的数据。 信息缓冲区包含相应的NDIS_PM_PROTOCOL_OFFLOAD结构。

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

NDIS_STATUS_INVALID_PARAMETER
指定的协议卸载标识符无效。

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

NDIS_STATUS_NOT_SUPPORTED
微型端口驱动程序的 NDIS 版本低于 6.20。

NDIS_STATUS_FAILURE
请求因上述原因以外的原因而失败。

要求

版本

在 NDIS 6.20 及更高版本中受支持。 对于微型端口驱动程序是必需的。 (请参见“备注”部分。)

标头

Ntddndis.h (包括 Ndis.h)

另请参阅

NDIS_PM_PROTOCOL_OFFLOAD

OID_PM_ADD_PROTOCOL_OFFLOAD