处理 CoNDIS WAN 微型端口驱动程序中的查询
本主题概述了在 CoNDIS WAN 微型端口驱动程序中处理查询的要求。 上层驱动程序使用查询请求调用 NdisCoOidRequest ,以确定 CoNDIS WAN 微型端口驱动程序和微型端口驱动程序的 NIC 特定于 WAN 的功能和当前状态。
在 NDISWAN 中间驱动程序转发查询请求后,NDIS 调用微型端口驱动程序的 MiniportCoOidRequest 函数。 在 CoNDIS WAN 微型端口驱动程序中,此函数与任何面向连接的微型端口驱动程序相同,只是 CoNDIS WAN 微型端口驱动程序支持 CoNDIS WAN 对象。
如果 CoNDIS WAN 微型端口驱动程序通过返回状态NDIS_STATUS_PENDING异步完成 MiniportCoOidRequest ,则必须稍后通过调用 NdisCoOidRequestComplete 来完成查询。
当 NDIS 调用 MiniportCoOidRequest 时,NDIS 会传递指向包含查询 OID 的 NDIS_OID_REQUEST 结构的指针,以及用于保存从微型端口驱动程序检索到的信息的缓冲区。 微型端口驱动程序控制此缓冲区,直到请求完成。 如果 NDIS_OID_REQUEST 的 InformationBufferLength 成员中指定的字节数不足以满足 OID 所需的信息,微型端口驱动程序应使查询请求失败,并将 NDIS_OID_REQUEST 的 BytesNeeded 成员设置为 OID 所需的字节数。
在当前查询请求完成之前,不会将任何其他请求提交到特定的 WAN 微型端口驱动程序。
下表汇总了用于获取或设置 CoNDIS WAN 微型端口驱动程序的操作特征的 OID。
名称 | 可选或必需 |
---|---|
OID_WAN_CO_GET_INFO 获取有关虚拟连接的信息 (VC) 。 | 必需 |
OID_WAN_CO_GET_LINK_INFO 获取有关 VC 的信息。 | 必需 |
OID_WAN_CO_GET_STATS_INFO 获取 VC 的统计信息。 | 可选 |
CoNDIS WAN 微型端口驱动程序可以支持所有 NDIS 常规对象。 若要详细了解如何在 CoNDIS 微型端口驱动程序中设置信息,请参阅 查询或设置信息。