NdisFOidRequest 函数 (ndis.h)
筛选器驱动程序调用 NdisFOidRequest 函数,将 OID 请求转发到基础驱动程序或发起此类请求。
语法
NDIS_STATUS NdisFOidRequest(
[in] NDIS_HANDLE NdisFilterHandle,
[in] PNDIS_OID_REQUEST OidRequest
);
参数
[in] NdisFilterHandle
标识筛选器模块的 NDIS 句柄。 NDIS 在对 FilterAttach 函数的调用中将句柄传递给筛选器驱动程序。
[in] OidRequest
指向 NDIS_OID_REQUEST 结构的指针,该结构指定使用给定OID_XXX 代码请求的作。 该结构可以指定查询、集或方法请求。 有关 OID 的详细信息,请参阅 NDIS OID。
返回值
请参阅 NdisOidRequest 函数。
言论
筛选器驱动程序可以通过调用 NdisFOidRequest来向基础驱动程序发起 OID 请求。
筛选器驱动程序还可以筛选由过度分配驱动程序发起的 OID 请求。 NDIS 调用 FilterOidRequest 函数来处理每个此类请求。
如果 NdisFOidRequest 返回 NDIS_STATUS_PENDING,则 NDIS 会在基础驱动程序完成 OID 请求后调用 FilterOidRequestComplete 函数。
如果 NdisFOidRequest 返回 NDIS_STATUS_SUCCESS,则会在 OidRequest 参数的 NDIS_OID_REQUEST 结构中返回查询请求的结果。
如果筛选器驱动程序在 NDIS_OID_REQUEST 结构的 标头 字段中传递无效 值,则 NdisFOidRequest 可以返回 NDIS_STATUS_INVALID_PARAMETER。
当驱动程序处于 重启、正在运行、暂停或 暂停 状态时,驱动程序可以调用 NdisFOidRequest。
要求
要求 | 价值 |
---|---|
最低支持的客户端 | NDIS 6.0 及更高版本中受支持。 |
目标平台 | 桌面 |
标头 | ndis.h (包括 Ndis.h) |
库 | Ndis.lib |
IRQL | <= DISPATCH_LEVEL |
DDI 符合性规则 | Irql_OID_Function(ndis) |