Compartir a través de

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

  • Artículo

El método IStillImage::SetupDeviceParameters permite a los clientes de la interfaz COM IStillImage modificar las características almacenadas de un dispositivo de imagen fija, si se desconoce el tipo de bus del dispositivo.

Sintaxis

HRESULT SetupDeviceParameters(
  [in, out] PSTI_DEVICE_INFORMATIONW unnamedParam1
);

Parámetros

[in, out] unnamedParam1

Define el parámetro PSTI_DEVICE_INFORMATIONWunnamedParam1.

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 método IStillImage::SetupDeviceParameters solo permite la modificación de los parámetros de dispositivo asociados a dispositivos de imagen para los que no se ha identificado un bus. Para estos dispositivos, el servidor de imágenes fija establece el miembro dwHardwareConfiguration de la estructura STI_DEVICE_INFORMATION del dispositivo en STI_HW_CONFIG_UNKNOWN cuando se llama a IStillImage::GetDeviceInfo .

Actualmente, el único parámetro de dispositivo que se puede modificar es el nombre del puerto del dispositivo. Al llamar a este método para modificar el nombre del puerto, se deben especificar los miembros dwSize, szDeviceInternalName y pszPortName del STI_DEVICE_INFORMATION. Se omiten todos los demás miembros.

Antes de llamar a IStillImage::SetupDeviceParameters, 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)