IStillImageW::CreateDevice-Methode (sti.h)
Die IStillImage::CreateDevice-Methode erstellt eine Instanz des COM-Objekts, die die IStiDevice COM Interfacedefiniert und einen Zeiger auf die Schnittstelle zurückgibt.
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 IStillImage::GetSTILaunchInformation oder IStillImage::GetDeviceList.
dwMode
Vom Aufrufer bereitgestellter Konstantenwert, der den Übertragungsmodi angibt in dem das Gerät verwendet werden soll. Die folgenden Werte sind gültig.
| Modus | Beschreibung |
|---|---|
| STI_DEVICE_CREATE_BOTH | Das Gerät wird sowohl zum Abrufen des Status als auch zum Übertragen von Daten 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 von Statusinformationen geöffnet. |
[out] pDevice
Empfängt einen Zeiger auf die IStiDevice COM Interface.
[in, optional] 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 IStiDevice--Schnittstelle verwenden kann, muss sie zuerst IStillImage::StiCreateInstance- aufrufen, um einen Zeiger auf die IStillImage--Schnittstelle abzurufen, und rufen Sie dann IStillImage::CreateDevice auf, 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 dargestellt, um Zugriff auf das angegebene Gerät zu erhalten.
Wenn Sie ein aggregiertes COM-Objekt erstellen möchten, das IStiDevice-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 in der Microsoft Windows SDK-Dokumentation und in der Component Object Model Specificationbeschrieben.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Desktop |
| Header- | sti.h (einschließlich Sti.h) |