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)
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