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.

[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

Siehe auch

IStiDevice::Release

IStillImageW-