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

O método IStillImage::SetupDeviceParameters permite que os clientes da interface IStillImage COM modifiquem as características armazenadas de um dispositivo de imagem ainda, 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 .

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::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 dwHardwareConfiguration membro da estrutura STI_DEVICE_INFORMATION do dispositivo para 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, szDeviceInternalNamee pszPortName membros 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
da Plataforma de Destino	Área de trabalho
cabeçalho	sti.h (inclua Sti.h)