NdisFDirectOidRequest 函数 (ndis.h)

筛选器驱动程序调用 NdisFDirectOidRequest 函数,以将直接 OID 请求转发到基础驱动程序或发起此类请求。

语法

NDIS_STATUS NdisFDirectOidRequest(
  [in] NDIS_HANDLE       NdisFilterHandle,
  [in] PNDIS_OID_REQUEST OidRequest
);

参数

[in] NdisFilterHandle

标识筛选器模块的 NDIS 句柄。 NDIS 在对 FilterAttach 函数的调用中将句柄传递给筛选器驱动程序。

[in] OidRequest

指向 NDIS_OID_REQUEST 结构的指针,该结构指定使用给定的 OID_Xxx 代码请求的操作。 结构可以指定 OID 查询、集或方法请求。

返回值

有关可能返回值的列表,请参阅 NdisDirectOidRequest 函数。

注解

NdisFDirectOidRequest 函数不能用于常规 OID 请求。 对于常规 OID 请求,请改用 NdisFOidRequest 函数。 NdisFDirectOidRequest 只能用于 NDIS 支持用于直接 OID 接口的 OID。 例如,可以使用以下 OID:

OID_TCP_TASK_IPSEC_OFFLOAD_V2_ADD_SA OID_TCP_TASK_IPSEC_OFFLOAD_V2_DELETE_SA OID_TCP_TASK_IPSEC_OFFLOAD_V2_UPDATE_SA

筛选器驱动程序可以通过调用 NdisFDirectOidRequest 将 OID 请求直接发起到基础驱动程序。

筛选器驱动程序还可以筛选由过分驱动程序发起的直接 OID 请求。 NDIS 调用 FilterDirectOidRequest 函数来处理每个此类请求。

如果 NdisFDirectOidRequest 返回 NDIS_STATUS_PENDING,则 NDIS 会在基础驱动程序完成 OID 请求后调用 FilterDirectOidRequestComplete 函数。 调用 NdisFDirectOidRequest 的 驱动程序必须注册 FilterDirectOidRequestComplete 函数。

当驱动程序处于“正在重启”、“正在运行”、“正在暂停”或“已暂停”状态时,可以调用 NdisFDirectOidRequest

直接 OID 请求接口类似于常规 OID 请求接口。 有关发出常规请求的详细信息,请参阅 NdisFOidRequest

要求

要求
最低受支持的客户端 在 NDIS 6.1 及更高版本中受支持。
目标平台 桌面
标头 ndis.h (包括 Ndis.h)
Library Ndis.lib
IRQL <= DISPATCH_LEVEL

另请参阅

FilterAttach

FilterDirectOidRequest

FilterDirectOidRequestComplete

NDIS_OID_REQUEST

NdisDirectOidRequest

NdisFOidRequest

OID_TCP_TASK_IPSEC_OFFLOAD_V2_ADD_SA OID_TCP_TASK_IPSEC_OFFLOAD_V2_DELETE_SA OID_TCP_TASK_IPSEC_OFFLOAD_V2_UPDATE_SA