Metodo IStillImageW::SetupDeviceParameters (sti.h)

Il metodo IStillImage::SetupDeviceParameters consente ai client dell'interfaccia COM IStillImage di modificare le caratteristiche archiviate di un dispositivo ancora immagine, se il tipo di bus del dispositivo è sconosciuto.

Sintassi

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

Parametri

[in, out] unnamedParam1

Definisce il parametro PSTI_DEVICE_INFORMATIONWsenza nomeParam1.

Valore restituito

Se l'operazione ha esito positivo, il metodo restituisce S_OK. In caso contrario, restituisce uno dei codici di errore con prefisso STIERR definiti in stierr.h.

Commenti

Il metodo IStillImage::SetupDeviceParameters consente solo la modifica dei parametri del dispositivo associati ai dispositivi ancora immagine per cui non è stato identificato un bus. Per tali dispositivi, il server immagine imposta il membro dwHardwareConfiguration della struttura STI_DEVICE_INFORMATION del dispositivo su STI_HW_CONFIG_UNKNOWN quando viene chiamato IStillImage::GetDeviceInfo .

Attualmente, l'unico parametro del dispositivo che può essere modificato è il nome della porta del dispositivo. Quando si chiama questo metodo per modificare il nome della porta, è necessario specificare i membri dwSize, szDeviceInternalName e pszPortName del STI_DEVICE_INFORMATION. Tutti gli altri membri vengono ignorati.

Prima di chiamare IStillImage::SetupDeviceParameters, i client dell'interfaccia COM IStillImage devono chiamare IStillImage :: StiCreateInstance per ottenere un puntatore dell'interfaccia IStillImage .

Requisiti

Requisito	Valore
Piattaforma di destinazione	Desktop
Intestazione	sti.h (include Sti.h)