Método IStillImageW::GetDeviceValue (sti.h)
O método IStillImage::GetDeviceValue retorna informações de registro associadas a um dispositivo de imagem ainda 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.
Valor de retorno
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.
Observações
A finalidade do método IStillImage::GetDeviceValue é retornar os valores atualmente atribuídos a entradas de registro de específicas do dispositivo para dispositivos de imagem morta. O método chama RegQueryValueEx (descrito na documentação do SDK do Microsoft Windows).
O método IStillImage::GetDeviceValue pode retornar um ANSI ou uma cadeia de caracteres 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 do IStillImage devem chamar IStillImage::StiCreateInstance para obter um ponteiro de interface IStillImage.
Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | sti.h (inclua Sti.h) |