Compartilhar via

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

  • Artigo

Obtém os valores de qualidade do sinal associados ao rádio da rede.

Sintaxe

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

Parâmetros

[out] puStrengthValue

A força do sinal atual. Esse parâmetro usa um valor ULONG entre 0 e puStrengthMax.

[out] puStrengthMax

O valor máximo de força do sinal. Esse parâmetro usa um valor ULONG entre 0 e 100. Por padrão, puStrengthMax é definido como 100.

Retornar valor

Os possíveis valores retornados incluem, mas não se limitam a, o seguinte.

Código de retorno Descrição
S_OK
 O método foi concluído com sucesso.
E_FAIL
 O método falhou.
E_INVALIDARG
 Um dos parâmetros é inválido.
E_OUTOFMEMORY
 O método não pôde alocar a memória necessária para executar essa operação.
E_POINTER
 Um ponteiro passado como um parâmetro não é válido.

Comentários

A força do sinal, nesse contexto, é medida em uma escala linear. Quando puStrengthMax é definido como o valor padrão de 100, puStrengthValue representa a porcentagem da força máxima do sinal atualmente usada para transmissão.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho adhoc.h

Confira também

IDot11AdHocNetwork