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) |
库 | Ndis.lib |
IRQL | <= DISPATCH_LEVEL |
另请参阅
FilterSynchronousOidRequestComplete
在 NDIS 6.80 中