Método IStillImageW::SetDeviceValue (sti.h)
O método IStillImage::SetDeviceValue define informações do Registro para um dispositivo de imagem ainda especificado.
Sintaxe
HRESULT SetDeviceValue(
[in] LPWSTR pwszDeviceName,
[in] LPWSTR pValueName,
DWORD Type,
[in] LPBYTE pData,
DWORD 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.
Type
Tipo de valor do Registro com prefixo REG_ fornecido pelo chamador. Para obter mais informações, consulte RegSetValueEx na documentação do SDK do Microsoft Windows.
[in] pData
Ponteiro fornecido pelo chamador para os dados a serem armazenados.
cbData
Tamanho fornecido pelo chamador, em bytes, dos dados apontados por pData. Para cadeias de caracteres terminadas em NULL, inclua o caractere NULL.
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::SetDeviceValue é definir valores para entradas de registro específicas do dispositivo para dispositivos de imagem ainda. O método chama RegSetValueEx (descrito na documentação do SDK do Microsoft Windows).
Antes de chamar IStillImage::SetDeviceValue, 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) |