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