IStillImageW::CreateDevice-Methode (sti.h)

  • Artikel

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)

Weitere Informationen

IStiDevice::Release

IStillImageW