Metodo IDot11AdHocNetwork::GetSignalQuality (adhoc.h)

Articolo
02/28/2024

Ottiene i valori di qualità del segnale associati alla radio della rete.

Sintassi

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

Parametri

[out] puStrengthValue

La forza del segnale corrente. Questo parametro accetta un valore ULONG compreso tra 0 e puStrengthMax.

[out] puStrengthMax

Valore massimo di forza del segnale. Questo parametro accetta un valore ULONG compreso tra 0 e 100. Per impostazione predefinita, puStrengthMax è impostato su 100.

Valore restituito

I valori restituiti possibili includono, ma non sono limitati ai valori seguenti.

Codice restituito	Descrizione
S_OK	Metodo completato correttamente.
E_FAIL	Il metodo non è riuscito.
E_INVALIDARG	Uno dei parametri non è valido.
E_OUTOFMEMORY	Impossibile allocare la memoria necessaria per eseguire questa operazione.
E_POINTER	Un puntatore passato come parametro non è valido.

Commenti

La forza del segnale, in questo contesto, viene misurata su una scala lineare. Quando puStrengthMax è impostato sul valore predefinito 100, puStrengthValue rappresenta la percentuale della forza massima del segnale attualmente utilizzata per la trasmissione.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	adhoc.h

Vedi anche

IDot11AdHocNetwork

Condividi tramite