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 einer der in stierr.h definierten Fehlercodes mit STIERR-Präfix zurückgegeben.
Hinweise
Die IStiDevice::Subscribe-Methode wird in der Regel von Anwendungen aufgerufen, die Ereignisse von Geräten abfangen und umleiten. Die -Methode ermöglicht es diesen Anwendungen, über Standbildgeräteereignisse benachrichtigt zu werden, damit sie dann die Steuerung an die entsprechenden Anzeigeanwendungen senden können.
Basierend auf inhalten, die in der STISUBSCRIBE-Struktur bereitgestellt werden, kann der Aufrufer anfordern, über Geräteereignisse durch Windows-Nachrichten oder durch Win32-Ereignisse (mittels 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 von IStiDevice::Subscribe mü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 |
| Kopfzeile | sti.h (einschließlich Sti.h) |