通过

从 NDIS 筛选器驱动程序生成 OID 请求

  • 项目

筛选器驱动程序可以通过调用 NdisFOidRequest 函数来发起 OID 查询或设置对基础驱动程序的请求。

下图演示了筛选器驱动程序发起的 OID 请求。

说明由 NDIS 筛选器驱动程序发起的 OID 请求的示意图。

在筛选器驱动程序调用 NdisFOidRequest 函数后，NDIS 将调用下一个基础驱动程序的请求函数。 有关微型端口驱动程序如何处理 OID 请求的详细信息，请参阅 适配器的 OID 请求。

为了同步完成， NdisFOidRequest 返回NDIS_STATUS_SUCCESS或错误状态。 为了异步完成， NdisFOidRequest 返回NDIS_STATUS_PENDING。

若要确定基础驱动程序成功处理了哪些信息，发出 OID 请求的筛选器驱动程序必须在 OID 请求返回后检查NDIS_OID_REQUEST结构中 SupportedRevision 成员中的值。 有关 NDIS 版本信息的详细信息，请参阅 指定 NDIS 版本信息。

如果 NdisFOidRequest 返回NDIS_STATUS_PENDING，则 NDIS 会在基础驱动程序完成 OID 请求后调用 FilterOidRequestComplete 函数。 在这种情况下，NDIS 在 FilterOidRequestComplete 的 OidRequest 参数处传递请求的结果。 NDIS 在 FilterOidRequestComplete 的 Status 参数中传递请求的最终状态。

如果 NdisFOidRequest 返回NDIS_STATUS_SUCCESS，它将在 OidRequest 参数处的 NDIS_OID_REQUEST 结构中返回查询请求的结果。 在这种情况下，NDIS 不会调用 FilterOidRequestComplete 函数。

当驱动程序处于“正在重启”、“正在运行”、“正在暂停”或“已暂停”状态时，驱动程序可以调用 NdisFOidRequest。

注意 筛选器驱动程序应跟踪其发起的 OID 请求，并确保在此类请求完成时不会调用 NdisFOidRequestComplete 函数。