Método IStillImageW::GetDeviceList (sti.h)
O método IStillImage::GetDeviceList retorna características de hardware para todos os dispositivos de imagem ainda instalados.
Sintaxe
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
Recebe o número de estruturas de STI_DEVICE_INFORMATION fornecidas no buffer referenciado por ppBuffer.
[out] ppBuffer
Recebe um identificador para um buffer alocado por STI. Esse buffer conterá uma matriz de estruturas STI_DEVICE_INFORMATION .
Retornar valor
Se a operação for bem-sucedida, o método retornará S_OK. Caso contrário, ele retornará um dos códigos de erro prefixados por STIERR definidos em stierr.h.
Comentários
O método IStillImage::GetDeviceList retorna uma estrutura STI_DEVICE_INFORMATION para cada dispositivo de imagem parada instalado. O conteúdo da estrutura normalmente é usado para criar exibições de interface do usuário e para localizar o nome interno de um dispositivo.
Antes de chamar IStillImage::GetDeviceList, os clientes da interface COM IStillImage devem chamar IStillImage::StiCreateInstance para obter um ponteiro de interface IStillImage .
Quando o chamador terminar de usar a matriz de estruturas STI_DEVICE_INFORMATION referenciadas por ppBuffer, ele deverá desalocar a matriz chamando LocalFree (descrito na documentação do SDK do Microsoft Windows).
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Área de Trabalho |
| Cabeçalho | sti.h (inclua Sti.h) |