IF_SET_OBJECT回调函数 (ndis.h)

ProviderSetObject 函数设置与网络接口关联的信息。

语法

IF_SET_OBJECT IfSetObject;

NDIS_STATUS() IfSetObject(
  [in] NDIS_HANDLE ProviderIfContext,
  [in] NET_IF_OBJECT_ID ObjectId,
  [in] ULONG InputBufferLength,
  [in] PVOID pInputBuffer
)
{...}

参数

[in] ProviderIfContext

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

[in] ObjectId

作为设置请求的目标的 对象的标识符。 有关适用于接口提供程序的对象标识符 (OID) 的列表,请参阅 NDIS 网络接口 OID

[in] InputBufferLength

pInputBuffer 指向的缓冲区的长度(以字节为单位)。

[in] pInputBuffer

指向输入缓冲区的指针,该缓冲区指定接口提供程序应用来设置对象数据的信息。

返回值

ProviderSetObject 返回以下状态值之一:

返回代码 说明
NDIS_STATUS_SUCCESS
操作已成功完成。
NDIS_STATUS_RESOURCES
由于资源不足,操作失败。
NDIS_STATUS_INVALID_PARAMETER
调用失败,因为某些输入参数无效。
NDIS_STATUS_Xxx
由于某种其他原因,调用失败。 此函数可以从它调用的函数传播错误代码,或生成相应的错误代码。

注解

NDIS 调用网络接口提供程序的 ProviderSetObject 函数来设置与提供程序注册的接口关联的信息。 有关适用于接口提供程序的 OID 列表,请参阅 NDIS 网络接口 OID

请注意,目前未定义设置的 OID。

NDIS 在 IRQL = PASSIVE_LEVEL 调用 ProviderSetObject

要求

要求
最低受支持的客户端 在 NDIS 6.0 及更高版本中受支持。
目标平台 Windows
标头 ndis.h (包括 Ndis.h)
IRQL PASSIVE_LEVEL

另请参阅

NdisIfRegisterInterface