通过

IF_QUERY_OBJECT回调函数 （ndis.h）

ProviderQueryObject 函数检索有关网络接口的信息。

语法

IF_QUERY_OBJECT IfQueryObject;

NDIS_STATUS() IfQueryObject(
  [in]      NDIS_HANDLE ProviderIfContext,
  [in]      NET_IF_OBJECT_ID ObjectId,
  [in, out] PULONG pOutputBufferLength,
  [out]     PVOID pOutputBuffer
)
{...}

参数

[in] ProviderIfContext

一个句柄，用于标识接口提供程序的接口上下文区域。 接口提供程序在调用 NDIS 时将此句柄传递给 NDIS NdisIfRegisterInterface 函数。

[in] ObjectId

作为查询请求目标的对象的标识符。 有关适用于接口提供程序的对象标识符（OID）列表，请参阅 NDIS 网络接口 OID。

[in, out] pOutputBufferLength

指向 NDIS 提供的变量的指针，其中 NDIS 提供输出缓冲区的长度。 ProviderQueryObject 写入输出缓冲区中放置的数据的长度。

[out] pOutputBuffer

指向 NDIS 提供的输出缓冲区的指针，其中 ProviderQueryObject 将响应写入查询请求。

返回值

ProviderQueryObject 返回以下状态值之一：

返回代码 描述
NDIS_STATUS_SUCCESS
 作已成功完成。
NDIS_STATUS_RESOURCES
 作由于资源不足而失败。
NDIS_STATUS_INVALID_PARAMETER
 调用失败，因为某些输入参数无效。
NDIS_STATUS_Xxx
 由于其他原因，调用失败。 此函数可以从调用的函数传播错误代码，或生成适当的错误代码。

言论

NDIS 调用网络接口提供程序的 ProviderQueryObject 函数，以获取有关提供程序注册的接口的信息。 有关适用于接口提供程序的 OID 列表，请参阅 NDIS 网络接口 OID。

NDIS 在 IRQL = PASSIVE_LEVEL 调用 ProviderQueryObject。

要求

要求 价值
最低支持的客户端 NDIS 6.0 及更高版本中受支持。
目标平台 窗户
标头 ndis.h （包括 Ndis.h）
IRQL PASSIVE_LEVEL

另请参阅

NdisIfRegisterInterface

  • Last updated on