NdisFSynchronousOidRequest 函数 (ndis.h)

筛选器驱动程序调用 NdisFSynchronousOidRequest 函数,以发起新的同步 OID 请求并将其颁发给基础驱动程序。

NDIS 6.81 及更高版本中支持此函数。

语法

NDIS_STATUS NdisFSynchronousOidRequest(
  [in] NDIS_HANDLE      NdisFilterModuleHandle,
  [in] NDIS_OID_REQUEST *OidRequest
);

参数

[in] NdisFilterModuleHandle

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

[in] OidRequest

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

返回值

此函数返回的值与 NdisDirectOidRequest相同的值,但从此函数返回NDIS_STATUS_PENDING 除外。

言论

NdisFSynchronousOidRequest 函数不能用于常规 OID 请求。 对于常规 OID 请求,请改用 NdisFOidRequest 函数。 NdisFSynchronousOidRequest 只能用于 NDIS 支持用于同步 OID 接口的 OID。 大多数筛选器驱动程序不需要调用 NdisFSynchronousOidRequest

在筛选器驱动程序发起的任何同步 OID 请求完成之前,筛选器驱动程序不得完成 FilterDetach

筛选器驱动程序不需要实现 FilterOidRequestCompleteFilterDirectOidRequestCompleteFilterSynchronousOidRequestFilterSynchronousOidRequestComplete,以便调用 NdisFSynchronousOidRequest。 顾名思义,同步 OID 请求始终同步完成,因此没有异步回调。

要求

要求 价值
最低支持的客户端 Windows 10 版本 1709
目标平台 普遍
标头 ndis.h (包括 Ndis.h)
Ndis.lib
IRQL <= DISPATCH_LEVEL

另请参阅

FilterSynchronousOidRequest

FilterSynchronousOidRequestComplete

在 NDIS 6.80 中 同步 OID 请求接口