IStillImageW::SetupDeviceParameters-Methode (sti.h)

Mit der IStillImage::SetupDeviceParameters-Methode können Clients der IStillImage-COM-Schnittstelle die gespeicherten Merkmale eines Standbildgeräts ändern, wenn der Bustyp des Geräts unbekannt ist.

Syntax

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

Parameter

[in, out] unnamedParam1

Definiert den PSTI_DEVICE_INFORMATIONW Parameter unnamedParam1.

Rückgabewert

Wenn der Vorgang erfolgreich ist, gibt die Methode S_OK zurück. Andernfalls wird einer der in stierr.h definierten Fehlercodes mit STIERR-Präfix zurückgegeben.

Hinweise

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

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

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

Anforderungen