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 de STI_DEVICE_INFORMATION.
Valor de retorno
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.
Observações
O método IStillImage::GetDeviceList retorna uma estrutura STI_DEVICE_INFORMATION para cada dispositivo de imagem ainda 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 IStillImage COM 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 |
|---|---|
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | sti.h (inclua Sti.h) |