StiCreateInstanceW-Funktion (sti.h)

Artikel
02/07/2025

Die StiCreateInstance--Funktion erstellt eine Instanz des COM-Objekts, die die IStillImage-schnittstelle definiert und einen Zeiger auf die Schnittstelle zurückgibt.

Syntax

HRESULT StiCreateInstanceW(
  HINSTANCE    hinst,
  DWORD        dwVer,
  IStillImageW **ppSti,
  LPUNKNOWN    punkOuter
);

Parameter

hinst

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

dwVer

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

ppSti

Empfängt einen Zeiger auf die IStillImage- Schnittstelle.

punkOuter

Optionaler, vom Aufrufer bereitgestellter Zeiger auf das "Steuern unbekannt" für die Objektaggregation. Weitere Informationen finden Sie im Folgenden Abschnitt "Anmerkungen".

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

Damit eine Anwendung die IStillImage--Schnittstelle verwenden kann, muss sie zuerst die StiCreateInstance--Funktion aufrufen, um einen Zeiger auf die Schnittstelle abzurufen. Der in ppSti empfangene Zeiger wird anschließend beim Aufrufen IStillImage- Methoden verwendet, wie im folgenden Beispiel veranschaulicht:

PSTI pSti = NULL;
DWORD dwStiTotal = 0;     // total number of STI devices found
PVOID pStiInfo = NULL;    // STI device info buffer
HRESULT hres = StiCreateInstance(GetModuleHandle(NULL), STI_VERSION, &pSti, NULL);
...
hhes = pSti->GetDeviceList(0, 0, &dwStiTotal, &pStiInfo);

Wenn Sie ein aggregiertes COM-Objekt erstellen möchten, das IStillImage-enthält, müssen Sie einen Zeiger auf das "Steuern unbekannt" in PunkOuter-angeben. In den meisten Fällen erstellen Sie kein Aggregatobjekt, daher sollte PunkOuter-NULL-sein. Objektaggregation und die unbekannte Steuerung werden im Artikel Aggregation und im Component Object Model Specificationbeschrieben.

Anforderungen

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

Siehe auch

IStillImage::Release

Freigeben über