IStillImageW::EnableHwNotifications-Methode (sti.h)

Die IStillImage::EnableHwNotifications-Methode fordert den stillen Bildereignismonitor an, die Benachrichtigung von Anwendungen zu aktivieren oder zu deaktivieren, wenn Still Image Device Events für ein angegebenes Gerät 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 IStillImage::GetSTILaunchInformation oder IStillImage::GetDeviceList.

bNewState

Der vom Aufrufer bereitgestellte Wert wird auf TRUE- festgelegt, 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 eine der STIERR-Präfixfehlercodes zurückgegeben, die in stierr.hdefiniert sind.

Bemerkungen

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

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

Anforderungen

Siehe auch

IStillImage::LaunchApplicationForDevice

IStillImageW-