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

Article
03/01/2024

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

Partager via