Поделиться через


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

Метод IStillImage::GetDeviceValue возвращает сведения реестра, связанные с указанным устройством по-прежнему.

Синтаксис

HRESULT GetDeviceValue(
  [in]      LPWSTR  pwszDeviceName,
  [in]      LPWSTR  pValueName,
  [out]     LPDWORD pType,
  [out]     LPBYTE  pData,
  [in, out] LPDWORD cbData
);

Параметры

[in] pwszDeviceName

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

[in] pValueName

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

[out] pType

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

[out] pData

Вызывающий указатель на буфер для получения возвращаемого значения.

[in, out] cbData

Предоставленный вызывающим объектом размер в байтах буфера, на который указывает pData. Метод изменяет это значение, чтобы представить размер возвращаемых данных. Если указанный размер буфера слишком мал, метод предоставляет необходимый размер буфера и возвращает код ошибки.

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

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

Замечания

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

Метод IStillImage::GetDeviceValue может возвращать anSI или строку Юникода. Он может возвращать строку Юникода только в том случае, если код построен как Юникод с определенным Юникодом.

Перед вызовом IStillImage::GetDeviceValueклиенты интерфейса IStillImage IStillImage должны вызывать IStillImage::StiCreateInstance для получения указателя интерфейса IStillImage.

Требования

Требование Ценность
целевая платформа Настольный
заголовка sti.h (include Sti.h)

См. также

IStillImage::SetDeviceValue

IStillImageW