StiCreateInstanceW-Funktion (sti.h)
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) |