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

El método IStillImage::GetDeviceList devuelve características de hardware para todos los dispositivos de imagen todavía instalados.

Sintaxis

HRESULT GetDeviceList(
        DWORD  dwType,
        DWORD  dwFlags,
  [out] DWORD  *pdwItemsReturned,
  [out] LPVOID *ppBuffer
);

Parámetros

dwType

Parámetro reservado, use NULL.

dwFlags

Parámetro reservado, use NULL.

[out] pdwItemsReturned

Recibe el número de estructuras de STI_DEVICE_INFORMATION proporcionadas en el búfer al que hace referencia ppBuffer.

[out] ppBuffer

Recibe un identificador de un búfer asignado por STI. Este búfer contendrá una matriz de estructuras STI_DEVICE_INFORMATION .

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::GetDeviceList devuelve una estructura STI_DEVICE_INFORMATION para cada dispositivo de imagen fija instalado. El contenido de la estructura se usa normalmente para crear pantallas de interfaz de usuario y para buscar el nombre interno de un dispositivo.

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

Cuando el autor de la llamada ha terminado de usar la matriz de estructuras de STI_DEVICE_INFORMATION a las que hace referencia ppBuffer, debe desasignar la matriz llamando a LocalFree (que se describe en la documentación de Microsoft Windows SDK).

Requisitos

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

Consulte también

IStillImage::GetDeviceInfo

IStillImageW