IStiDevice::Subscribe-Methode (sti.h)
Die IStiDevice::Subscribe-Methode registriert den Aufrufer, um Benachrichtigungen über Geräteereignisse zu empfangen.
Syntax
HRESULT Subscribe(
[in, out] LPSTISUBSCRIBE lpSubsribe
);
Parameter
[in, out] lpSubsribe
Vom Aufrufer bereitgestellter Zeiger auf eine STISUBSCRIBE Struktur, die Abonnementparameterwerte enthält.
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 IStiDevice::Subscribe-Methode wird in der Regel von Anwendungen aufgerufen, die Ereignisse von Geräten abfangen und umleiten. Mit der Methode können diese Anwendungen über Still Image Device Events benachrichtigt werden, damit sie die Steuerung dann an entsprechende Anzeigeanwendungen verteilen können.
Basierend auf inhalten, die in der STISUBSCRIBE Struktur bereitgestellt werden, kann der Aufrufer anfordern, von Windows-Nachrichten oder win32-Ereignissen (mithilfe von SetEvent--Aufrufen) benachrichtigt zu werden.
Wenn die Anwendung eine Benachrichtigung über ein Ereignis empfängt, kann sie IStiDevice::GetLastNotificationData- aufrufen, um herauszufinden, welches Ereignis aufgetreten ist.
Vor dem Aufrufen IStiDevice::Subscribemüssen Clients der IStiDevice COM-Schnittstelle IStillImage::CreateDevice aufrufen, um einen IStiDevice Schnittstellenzeiger abzurufen, der Zugriff auf ein angegebenes Gerät ermöglicht.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Desktop |
| Header- | sti.h (einschließlich Sti.h) |