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)

Confira também

IStillImage::GetDeviceValue

IStillImageW