Método IStillImageW::GetDeviceValue (sti.h)

O método IStillImage::GetDeviceValue retorna informações do Registro associadas a um dispositivo de imagem parada especificado.

Sintaxe

HRESULT GetDeviceValue(
  [in]      LPWSTR  pwszDeviceName,
  [in]      LPWSTR  pValueName,
  [out]     LPDWORD pType,
  [out]     LPBYTE  pData,
  [in, out] LPDWORD cbData
);

Parâmetros

[in] pwszDeviceName

Ponteiro fornecido pelo chamador para uma cadeia de caracteres que representa um nome de dispositivo interno, obtido chamando IStillImage::GetSTILaunchInformation ou IStillImage::GetDeviceList.

[in] pValueName

Ponteiro fornecido pelo chamador para uma cadeia de caracteres que representa um nome de valor do Registro.

[out] pType

Recebe uma constante que representa o tipo de dados do valor retornado do Registro.

[out] pData

Ponteiro fornecido pelo chamador para um buffer para receber um valor retornado.

[in, out] cbData

Tamanho fornecido pelo chamador, em bytes, do buffer apontado por pData. O método modifica esse valor para representar o tamanho dos dados retornados. Se o tamanho do buffer especificado for muito pequeno, o método fornecerá o tamanho do buffer necessário e retornará um código de erro.

Retornar valor

Se a operação for bem-sucedida, o método retornará S_OK. Caso contrário, ele retornará um dos códigos de erro prefixados por STIERR definidos em stierr.h.

Comentários

A finalidade do método IStillImage::GetDeviceValue é retornar os valores atualmente atribuídos a Entradas de Registro específicas do dispositivo para dispositivos de imagem ainda. O método chama RegQueryValueEx (descrito na documentação do SDK do Microsoft Windows).

O método IStillImage::GetDeviceValue pode retornar uma cadeia de caracteres ANSI ou Unicode. Ele só poderá retornar uma cadeia de caracteres Unicode se o código for criado como Unicode com Unicode definido.

Antes de chamar IStillImage::GetDeviceValue, os clientes da interface COM IStillImage devem chamar IStillImage::StiCreateInstance para obter um ponteiro de interface IStillImage .

Requisitos

Requisito	Valor
Plataforma de Destino	Área de Trabalho
Cabeçalho	sti.h (inclua Sti.h)

Confira também

IStillImage::SetDeviceValue

IStillImageW