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) |