Método IStillImageW::SetupDeviceParameters (sti.h)

O método IStillImage::SetupDeviceParameters permite que os clientes da interface COM IStillImage modifiquem as características armazenadas de um dispositivo de imagem parada, se o tipo de barramento do dispositivo for desconhecido.

Sintaxe

HRESULT SetupDeviceParameters(
  [in, out] PSTI_DEVICE_INFORMATIONW unnamedParam1
);

Parâmetros

[in, out] unnamedParam1

Define o parâmetro PSTI_DEVICE_INFORMATIONWsem nomeParam1.

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::SetupDeviceParameters permite apenas a modificação de parâmetros de dispositivo associados a dispositivos de imagem ainda para os quais um barramento não foi identificado. Para esses dispositivos, o servidor de imagem ainda define o membro dwHardwareConfiguration da estrutura STI_DEVICE_INFORMATION do dispositivo como STI_HW_CONFIG_UNKNOWN quando IStillImage::GetDeviceInfo é chamado.

Atualmente, o único parâmetro de dispositivo que pode ser modificado é o nome da porta do dispositivo. Ao chamar esse método para modificar o nome da porta, os membros dwSize, szDeviceInternalName e pszPortName do STI_DEVICE_INFORMATION devem ser especificados. Todos os outros membros são ignorados.

Antes de chamar IStillImage::SetupDeviceParameters, os clientes da interface COM IStillImage devem chamar IStillImage::StiCreateInstance para obter um ponteiro de interface IStillImage .

Requisitos

Requisito	Valor
Plataforma de Destino	Área de Trabalho
Cabeçalho	sti.h (inclua Sti.h)