Méthode IDot11AdHocNetwork ::GetSignalQuality (adhoc.h)

  • Article

Obtient les valeurs de qualité du signal associées à la radio du réseau.

Syntaxe

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

Paramètres

[out] puStrengthValue

Puissance du signal actuel. Ce paramètre prend une valeur ULONG comprise entre 0 et puStrengthMax.

[out] puStrengthMax

Valeur de force maximale du signal. Ce paramètre prend une valeur ULONG comprise entre 0 et 100. Par défaut, puStrengthMax est défini sur 100.

Valeur retournée

Les valeurs de retour possibles incluent, sans s’y limiter, les éléments suivants.

Code de retour Description
S_OK
 La commande s'est correctement terminée.
E_FAIL
 La méthode a échoué.
E_INVALIDARG
 L’un des paramètres n’est pas valide.
E_OUTOFMEMORY
 La méthode n’a pas pu allouer la mémoire nécessaire pour effectuer cette opération.
E_POINTER
 Un pointeur passé en tant que paramètre n’est pas valide.

Remarques

Dans ce contexte, la force du signal est mesurée sur une échelle linéaire. Lorsque puStrengthMax est défini sur la valeur par défaut de 100, puStrengthValue représente le pourcentage de la force maximale du signal actuellement utilisée pour la transmission.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau uniquement]
Plateforme cible Windows
En-tête adhoc.h

Voir aussi

IDot11AdHocNetwork