IStillImageW::SetupDeviceParameters-Methode (sti.h)

Die IStillImage::SetupDeviceParameters--Methode ermöglicht Clients der IStillImage- COM-Schnittstelle, die gespeicherten Merkmale eines stillen Bildgeräts zu ändern, wenn der Bustyp des Geräts unbekannt ist.

Syntax

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

Parameter

[in, out] unnamedParam1

Definiert den parameter PSTI_DEVICE_INFORMATIONWunnamedParam1.

Rückgabewert

Wenn der Vorgang erfolgreich ist, gibt die Methode S_OK zurück. Andernfalls wird eine der STIERR-Präfixfehlercodes zurückgegeben, die in stierr.hdefiniert sind.

Bemerkungen

Die IStillImage::SetupDeviceParameters Methode ermöglicht nur die Änderung von Geräteparametern, die mit stillen Bildgeräten verknüpft sind, für die kein Bus identifiziert wurde. Für solche Geräte legt der Stillbildserver die dwHardwareConfiguration Mitglied der STI_DEVICE_INFORMATION Struktur des Geräts auf STI_HW_CONFIG_UNKNOWN fest, wenn IStillImage::GetDeviceInfo- aufgerufen wird.

Derzeit ist der einzige Geräteparameter, der geändert werden kann, der Portname des Geräts. Beim Aufrufen dieser Methode zum Ändern des Portnamens müssen die dwSize, szDeviceInternalNameund pszPortName Member der STI_DEVICE_INFORMATION angegeben werden. Alle anderen Member werden ignoriert.

Vor dem Aufrufen IStillImage::SetupDeviceParametersmüssen Clients der IStillImage- COM-Schnittstelle IStillImage::StiCreateInstance aufrufen, um einen IStillImage Schnittstellenzeiger abzurufen.

Anforderungen

Anforderung	Wert
Zielplattform-	Desktop
Header-	sti.h (einschließlich Sti.h)