Método IStillImageW::GetDeviceInfo (sti.h)
O método IStillImage::GetDeviceInfo retorna características de hardware para um dispositivo de imagem parada 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 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::GetDeviceInfo retorna uma estrutura STI_DEVICE_INFORMATION para o dispositivo de imagem parada especificado. O conteúdo da estrutura normalmente é 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 |
---|---|
Plataforma de Destino | Área de Trabalho |
Cabeçalho | sti.h (inclua Sti.h) |