STISUBSCRIBE-Struktur (sti.h)

Artikel
02/26/2024

Die STISUBSCRIBE-Struktur wird als Parameter für die IStiDevice::Subscribe-Methode verwendet.

Syntax

typedef struct _STISUBSCRIBE {
  DWORD  dwSize;
  DWORD  dwFlags;
  DWORD  dwFilter;
  HWND   hWndNotify;
  HANDLE hEvent;
  UINT   uiNotificationMessage;
} STISUBSCRIBE, *LPSTISUBSCRIBE;

Member

dwSize

Vom Aufrufer bereitgestellte Größe der STISUBSCRIBE-Struktur in Bytes.

dwFlags

Eines der folgenden Bitflags, definiert in sti.h.

STI_SUBSCRIBE_FLAG_EVENT

Ereignisbenachrichtigungen sollten durch Aufrufe von SetEvent an die Anwendung übermittelt werden. Das hEvent-Element enthält ein Win32-Ereignishandle.

Dieses Bitflag wird aus Sicherheitsgründen bevorzugt.

STI_SUBSCRIBE_FLAG_WINDOW

Ereignisbenachrichtigungen sollten mithilfe von Fenstermeldungen an die Anwendung übermittelt werden. Das dwWndNotify-Element enthält ein Fensterhandle und uiNotificationMessage eine Fenstermeldung.

Dieses Bitflag ist veraltet. Nicht verwenden.

dwFilter

Ist für das System reserviert.

hWndNotify

Handle für ein Anwendungsfenster, das die von uiNotificationMessage angegebene Meldung empfangen soll, wenn ein Ereignis auftritt. Wird nur verwendet, wenn STI_SUBSCRIBE_FLAG_WINDOW in dwFlags festgelegt ist.

hEvent

Behandeln Sie ein mit CreateEvent erstelltes Win32-Ereignis, das der Ereignismonitor mit SetEvent verwendet, wenn ein Ereignis auftritt und auf das die Anwendung warten kann. Wird nur verwendet, wenn STI_SUBSCRIBE_FLAG_WINDOW in dwFlags festgelegt ist.

uiNotificationMessage

Fenstermeldung, die an das dwWndNotify-Fenster übergeben werden soll, wenn ein Ereignis auftritt.

Anforderungen

Anforderung	Wert
Header	sti.h (einschließlich Sti.h)

Freigeben über