IStillImageW::EnableHwNotifications-Methode (sti.h)

Die IStillImage::EnableHwNotifications-Methode fordert den Monitor des Standbildereignisses an, um die Benachrichtigung von Anwendungen zu aktivieren oder zu deaktivieren, wenn Für ein angegebenes Gerät Standbildgeräteereignisse auftreten.

Syntax

HRESULT EnableHwNotifications(
  [in] LPCWSTR pwszDeviceName,
       BOOL    bNewState
);

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.

bNewState

Legen Sie den vom Aufrufer angegebenen Wert auf TRUE fest, um Benachrichtigungen zu aktivieren, und false , um sie zu deaktivieren.

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

Die IStillImage::EnableHwNotifications-Methode aktiviert oder deaktiviert Benachrichtigungen über Standbildgeräteereignisse für alle Anwendungen, nicht nur für die aufrufende Anwendung. Ereignisbenachrichtigungen sind standardmäßig aktiviert. Diese Methode ist für die Verwendung durch Anwendungen vorgesehen, die Ereignisse von Geräten abfangen und umleiten.

Vor dem Aufrufen von IStillImage::EnableHwNotifications müssen Clients der IStillImage-COM-Schnittstelle IStillImage::StiCreateInstance aufrufen, um einen IStillImage-Schnittstellenzeiger abzurufen.

Anforderungen

Anforderung	Wert
Zielplattform	Desktop
Kopfzeile	sti.h (einschließlich Sti.h)

Weitere Informationen

IStillImage::LaunchApplicationForDevice

IStillImageW