IDot11AdHocNetwork::GetSignalQuality 方法 (adhoc.h)

获取与网络无线电关联的信号质量值。

语法

HRESULT GetSignalQuality(
  [out] ULONG *puStrengthValue,
  [out] ULONG *puStrengthMax
);

参数

[out] puStrengthValue

当前信号强度。 此参数采用介于 0 和 puStrengthMax 之间的 ULONG 值。

[out] puStrengthMax

最大信号强度值。 此参数采用介于 0 和 100 之间的 ULONG 值。 默认情况下, puStrengthMax 设置为 100。

返回值

可能的返回值包括但不限于以下值。

返回代码 说明
S_OK
该方法已成功完成。
E_FAIL
方法失败。
E_INVALIDARG
其中一个参数无效。
E_OUTOFMEMORY
方法无法分配执行此操作所需的内存。
E_POINTER
作为参数传递的指针无效。

注解

在此上下文中,信号强度是按线性刻度测量的。 当 puStrengthMax 设置为默认值 100 时, puStrengthValue 表示当前用于传输的最大信号强度的百分比。

要求

要求
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 adhoc.h

另请参阅

IDot11AdHocNetwork