Метод IStillImageW::SetDeviceValue (sti.h)

  • Статья

Метод IStillImage::SetDeviceValue задает сведения о реестре для указанного устройства с изображением.

Синтаксис

HRESULT SetDeviceValue(
  [in] LPWSTR pwszDeviceName,
  [in] LPWSTR pValueName,
       DWORD  Type,
  [in] LPBYTE pData,
       DWORD  cbData
);

Параметры

[in] pwszDeviceName

Предоставленный вызывающим элементом указатель на строку, представляющую имя внутреннего устройства, полученное путем вызова IStillImage::GetSTILaunchInformation или IStillImage::GetDeviceList.

[in] pValueName

Предоставленный вызывающим элементом указатель на строку, представляющую имя значения реестра.

Type

Предоставленный вызывающим REG_ типом значения реестра с префиксом. Дополнительные сведения см. в разделе RegSetValueEx документации по Microsoft Windows SDK.

[in] pData

Предоставленный вызывающим элементом указатель на данные для хранения.

cbData

Предоставленный вызывающим абонентом размер данных в байтах, на которые указывает pData. Для строк, завершающихся значением NULL, добавьте символ NULL.

Возвращаемое значение

Если операция выполнена успешно, метод возвращает S_OK. В противном случае возвращается один из кодов ошибок с префиксом STIERR, определенных в stierr.h.

Комментарии

Цель метода IStillImage::SetDeviceValue заключается в том, чтобы задать значения для записей реестра, относящихся к конкретному устройству, для устройств с неподвижным образом. Метод вызывает RegSetValueEx (описан в документации по Microsoft Windows SDK).

Перед вызовом IStillImage::SetDeviceValue клиенты COM-интерфейса IStillImage должны вызвать IStillImage::StiCreateInstance , чтобы получить указатель интерфейса IStillImage .

Требования

Требование Значение
Целевая платформа Персональный компьютер
Верхняя часть sti.h (включая Sti.h)

См. также раздел

IStillImage::GetDeviceValue

IStillImageW