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 NdisIfRegisterInterface 函数。
[in] ObjectId
作为查询请求目标的 对象的标识符。 有关适用于接口提供程序的对象标识符 (OID) 的列表,请参阅 NDIS 网络接口 OID。
[in, out] pOutputBufferLength
指向 NDIS 提供的变量的指针,其中 NDIS 提供输出缓冲区的长度。 ProviderQueryObject 写入它放入输出缓冲区的数据的长度。
[out] pOutputBuffer
指向 NDIS 提供的输出缓冲区的指针, ProviderQueryObject 在其中将响应写入查询请求。
返回值
ProviderQueryObject 返回以下状态值之一:
返回代码 | 说明 |
---|---|
|
操作已成功完成。 |
|
由于资源不足,操作失败。 |
|
调用失败,因为某些输入参数无效。 |
|
由于其他某种原因,调用失败。 此函数可以从它调用的函数传播错误代码,或生成相应的错误代码。 |
注解
NDIS 调用网络接口提供程序的 ProviderQueryObject 函数以获取有关提供程序注册的接口的信息。 有关适用于接口提供程序的 OID 列表,请参阅 NDIS 网络接口 OID。
NDIS 在 IRQL = PASSIVE_LEVEL 调用 ProviderQueryObject 。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | 在 NDIS 6.0 及更高版本中受支持。 |
目标平台 | Windows |
标头 | ndis.h (包括 Ndis.h) |
IRQL | PASSIVE_LEVEL |