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) |