Método IStillImageW::GetDeviceValue (sti.h)

El método IStillImage::GetDeviceValue devuelve información del Registro asociada a un dispositivo de imagen todavía especificado.

Sintaxis

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

Parámetros

[in] pwszDeviceName

Puntero proporcionado por el autor de la llamada a una cadena que representa un nombre de dispositivo interno, obtenido llamando a IStillImage::GetSTILaunchInformation o IStillImage::GetDeviceList.

[in] pValueName

Puntero proporcionado por el autor de la llamada a una cadena que representa un nombre de valor del Registro.

[out] pType

Recibe una constante que representa el tipo de datos del valor del Registro devuelto.

[out] pData

Puntero proporcionado por el autor de la llamada a un búfer para recibir un valor devuelto.

[in, out] cbData

Tamaño proporcionado por el autor de la llamada, en bytes, del búfer al que apunta pData. El método modifica este valor para representar el tamaño de los datos devueltos. Si el tamaño del búfer especificado es demasiado pequeño, el método proporciona el tamaño de búfer necesario y devuelve un código de error.

Valor devuelto

Si la operación se realiza correctamente, el método devuelve S_OK. De lo contrario, devuelve uno de los códigos de error con prefijo STIERR definidos en stierr.h.

Comentarios

El propósito del método IStillImage::GetDeviceValue es devolver los valores asignados actualmente a entradas del Registro específicas del dispositivo para dispositivos de imagen fija. El método llama a RegQueryValueEx (descrito en la documentación de Microsoft Windows SDK).

El método IStillImage::GetDeviceValue puede devolver una cadena ANSI o Unicode. Solo puede devolver una cadena Unicode si el código se compila como Unicode con Unicode definido.

Antes de llamar a IStillImage::GetDeviceValue, los clientes de la interfaz COM IStillImage deben llamar a IStillImage::StiCreateInstance para obtener un puntero de interfaz IStillImage .

Requisitos

Requisito	Value
Plataforma de destino	Escritorio
Encabezado	sti.h (include Sti.h)

Consulte también

IStillImage::SetDeviceValue

IStillImageW