IStiDevice::Initialize-Methode (sti.h)

Diese Methode dient nur zur internen Verwendung.

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

Syntax

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

Parameter

[in] hinst

Vom Aufrufer bereitgestellte instance Handle des Aufrufprozesses. 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 von IStillImage::GetSTILaunchInformation.

dwVersion

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

dwMode

Vom Aufrufer bereitgestellter konstanter Wert, der die Übertragungsmodi angibt, in denen das Gerät verwendet werden soll. Die folgenden Werte sind gültig.

Mode	BESCHREIBUNG
STI_DEVICE_CREATE_BOTH	Das Gerät wird sowohl für das Abrufen status als auch für die Datenübertragung 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 status Informationen geöffnet.

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 IStiDevice::Initialize-Methode initialisiert das COM-Objekt instance, das durch Aufrufen von IStillImage::CreateDevice erstellt wurde.

Da IStiDevice::Initialize von IStillImage::CreateDevice aufgerufen wird, rufen Clients der IStiDevice-Schnittstelle diese Methode in der Regel nicht direkt auf.

Anforderungen

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