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)

Confira também

IStillImage::GetDeviceList

IStillImageW