StiCreateInstanceW-Funktion (sti.h)

Artikel
03/05/2024

Die StiCreateInstance-Funktion erstellt eine instance des COM-Objekts, das die IStillImage-Schnittstelle definiert, und gibt einen Zeiger auf die Schnittstelle zurück.

Syntax

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

Parameter

hinst

Vom Aufrufer bereitgestellte instance Handle des aufrufenden Prozesses. Dieses Handle wird durch Aufrufen von GetModuleHandle(NULL) abgerufen.

dwVer

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

ppSti

Empfängt einen Zeiger auf die IStillImage-Schnittstelle .

punkOuter

Optional, vom Aufrufer bereitgestellter Zeiger auf das "Steuern unbekannt" für die Objektaggregation. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise" .

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

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 von 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 bereitstellen. In den meisten Fällen erstellen Sie kein Aggregatobjekt, daher sollte punkOuterNULL sein. Objektaggregation und das Steuern unbekannt werden im Artikel Aggregation und in der Spezifikation des Komponentenobjektmodells beschrieben.

Anforderungen

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

Weitere Informationen

IStillImage::Release