Método IDeviceSpecificProperty::Get4BRange (devicetopology.h)

O método Get4BRange obtém o intervalo de 4 bytes do valor da propriedade específica do dispositivo.

Sintaxe

HRESULT Get4BRange(
  [out] LONG *plMin,
  [out] LONG *plMax,
  [out] LONG *plStepping
);

Parâmetros

[out] plMin

Ponteiro para uma variável LONG na qual o método grava o valor mínimo da propriedade.

[out] plMax

Ponteiro para uma variável LONG na qual o método grava o valor máximo da propriedade.

[out] plStepping

Ponteiro para uma variável LONG na qual o método grava o valor de etapa entre valores de propriedade consecutivos no intervalo *plMin como *plMax. Se a diferença entre os valores de propriedade máxima e mínima for d e o intervalo for dividido em n etapas (intervalos de tamanho uniforme), a propriedade poderá levar n + 1 valores discretos e o tamanho da etapa entre valores consecutivos será d/n.

Retornar valor

Se o método for bem-sucedido, retornará S_OK. Se falhar, os códigos de retorno possíveis incluem, mas não se limitam a, os valores mostrados na tabela a seguir.

Código de retorno	Descrição
E_POINTER	O ponteiro plMin, plMax ou plStepping é NULL.
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)	O valor da propriedade não é um inteiro assinado ou sem sinal de 32 bits. Para obter informações sobre essa macro, consulte a documentação do SDK do Windows.

Comentários

Esse método relata o intervalo e o tamanho da etapa para um valor de propriedade que é um inteiro com sinal de 32 bits ou sem sinal. Esses dois tipos de dados são representados por constantes de enumeração VARENUM VT_I4 e VT_UI4, respectivamente. Se o valor da propriedade não for um inteiro de 32 bits, o método retornará um erro status código. Para obter mais informações sobre VARENUM, consulte a documentação do SDK do Windows.

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	devicetopology.h

Confira também

IDeviceSpecificProperty Interface