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 de 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.
Observaciones
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 IStillImage COM de 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 del SDK de Microsoft Windows).
Requisitos
Requisito | Valor |
---|---|
de la plataforma de destino de | Escritorio |
encabezado de | sti.h (include Sti.h) |