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 。

实现 FilterOidRequestComplete、 FilterDirectOidRequestComplete、 FilterSynchronousOidRequest 或 FilterSynchronousOidRequestComplete 不需要筛选器 驱动程序即可调用 NdisFSynchronousOidRequest。 顾名思义，同步 OID 请求始终同步完成，因此没有异步回调。

要求

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

另请参阅

FilterSynchronousOidRequest

FilterSynchronousOidRequestComplete

NDIS 6.80 中的同步 OID 请求接口