IStiDevice::Initialize-Methode (sti.h)

Artikel
02/07/2025

Diese Methode ist nur für die interne Verwendung vorgesehen.

Die IStiDevice::Initialize-Methode initialisiert eine Instanz des COM-Objekts, die die IStiDevice- Schnittstelle definiert.

Syntax

HRESULT Initialize(
  [in] HINSTANCE hinst,
  [in] LPCWSTR   pwszDeviceName,
       DWORD     dwVersion,
       DWORD     dwMode
);

Parameter

[in] hinst

Vom Aufrufer bereitgestellte Instanzhandle des Aufrufvorgangs. Dieses Handle wird durch Aufrufen von GetModuleName(NULL) abgerufen.

[in] pwszDeviceName

Vom Aufrufer bereitgestellter Zeiger auf eine Zeichenfolge, die einen internen Gerätenamen darstellt, abgerufen durch Aufrufen IStillImage::GetSTILaunchInformation.

dwVersion

Vom Anrufer bereitgestellte STI-Versionsnummer. Dieser Wert muss STI_VERSION sein, definiert in Sti.h.

dwMode

Vom Aufrufer bereitgestellter Konstantenwert, der den Übertragungsmodi angibt in dem das Gerät verwendet werden soll. Die folgenden Werte sind gültig.

Modus	Beschreibung
STI_DEVICE_CREATE_BOTH	Das Gerät wird sowohl zum Abrufen des Status als auch zum Übertragen von Daten geöffnet.
STI_DEVICE_CREATE_DATA	Das Gerät wird nur für Datenübertragungen geöffnet.
STI_DEVICE_CREATE_STATUS	Das Gerät wird nur zum Abrufen von Statusinformationen geöffnet.

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 IStiDevice::Initialize-Methode initialisiert die COM-Objektinstanz, die durch Aufrufen IStillImage::CreateDeviceerstellt wurde.

Da IStiDevice::Initialize von IStillImage::CreateDeviceaufgerufen wird, rufen Clients der IStiDevice Schnittstelle diese Methode normalerweise nicht direkt auf.

Anforderungen

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

Freigeben über