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)
Library Ndis.lib
IRQL <= DISPATCH_LEVEL

另请参阅

FilterSynchronousOidRequest

FilterSynchronousOidRequestComplete

NDIS 6.80 中的同步 OID 请求接口