IStillImageW::CreateDevice-Methode (sti.h)
Die IStillImage::CreateDevice-Methode erstellt eine instance des COM-Objekts, das die IStiDevice-COM-Schnittstelle definiert, und gibt einen Zeiger auf die Schnittstelle zurück.
Syntax
HRESULT CreateDevice(
[in] LPWSTR pwszDeviceName,
DWORD dwMode,
[out] PSTIDEVICE *pDevice,
[in, optional] LPUNKNOWN punkOuter
);
Parameter
[in] pwszDeviceName
Vom Aufrufer bereitgestellter Zeiger auf eine Zeichenfolge, die einen internen Gerätenamen darstellt, abgerufen durch Aufrufen von IStillImage::GetSTILaunchInformation oder IStillImage::GetDeviceList.
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. |
[out] pDevice
Empfängt einen Zeiger auf die IStiDevice-COM-Schnittstelle.
[in, optional] punkOuter
Optionaler, vom Aufrufer bereitgestellter Zeiger auf den "steuernden unbekannten" für die Objektaggregation. Weitere Informationen finden Sie im 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 IStiDevice-Schnittstelle verwendet, muss sie zuerst IStillImage::StiCreateInstance aufrufen, um einen Zeiger auf die IStillImage-Schnittstelle zu erhalten, und dann IStillImage::CreateDevice aufrufen, um einen Zeiger auf die IStiDevice-Schnittstelle abzurufen. Der in pDevice empfangene Zeiger wird anschließend verwendet, wenn IStiDevice-Methoden aufgerufen werden, wie im Beispielbildcode veranschaulicht, um Zugriff auf das angegebene Gerät zu erhalten.
Wenn Sie ein aggregates COM-Objekt erstellen möchten, das IStiDevice enthält, müssen Sie einen Zeiger auf das "steuernde Unbekannte" in punkOuter angeben. In den meisten Fällen erstellen Sie kein Aggregatobjekt, daher sollte punkOuterNULL sein. Objektaggregation und steuernde Unbekannte werden in der Microsoft Windows SDK Dokumentation und in der Spezifikation des Komponentenobjektmodells beschrieben.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Desktop |
| Kopfzeile | sti.h (einschließlich Sti.h) |