Método IStillImageW::GetDeviceInfo (sti.h)
O método IStillImage::GetDeviceInfo retorna características de hardware para um dispositivo de imagem ainda especificado.
Sintaxe
HRESULT GetDeviceInfo(
[in] LPWSTR pwszDeviceName,
[out] LPVOID *ppBuffer
);
Parâmetros
[in] pwszDeviceName
Ponteiro fornecido pelo chamador para uma cadeia de caracteres que representa um nome de dispositivo interno, obtido chamando IStillImage::GetSTILaunchInformation ou IStillImage::GetDeviceList.
[out] ppBuffer
Recebe um identificador para uma estrutura 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::GetDeviceInfo retorna uma estrutura STI_DEVICE_INFORMATION para o dispositivo de imagem morta especificado. Normalmente, o conteúdo da estrutura é usado para criar exibições de interface do usuário.
Antes de chamar IStillImage::GetDeviceInfo, os clientes da interface com IStillImage devem chamar IStillImage::StiCreateInstance para obter um ponteiro de interface IStillImage.
Quando o chamador terminar de usar a estrutura STI_DEVICE_INFORMATION referenciada por ppBuffer, ele deverá desalocar o buffer 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) |