IStiUSD::SetNotificationHandle-Methode (stiusd.h)

Die IStiUSD::SetNotificationHandle-Methode eines Standbildminidrivers gibt ein Ereignishandle an, das der Minitreiber verwenden soll, um den Aufrufer über Geräteereignisse zu informieren.

Syntax

HRESULT SetNotificationHandle(
  HANDLE hEvent
);

Parameter

hEvent

Vom Aufrufer bereitgestelltes Handle für ein Win32-Ereignis, das durch Aufrufen von CreateEvent erstellt wurde.

Rückgabewert

Wenn der Vorgang erfolgreich ist, sollte die Methode S_OK zurückgeben. Andernfalls sollte einer der in stierr.h definierten Fehlercodes mit STIERR-Präfix zurückgegeben werden.

Hinweise

Wenn der Treiber (und das Gerät) asynchrone Benachrichtigungen über Standbildgeräteereignisse unterstützen, ist die IStiUSD::SetNotificationHandle-Methode des Minitreibers das Mittel, mit dem der Ereignismonitor den Treiber auffordert, ihn zu benachrichtigen, wenn ein Ereignis auftritt.

Wenn hEvent ein Ereignishandle ist, sollte die IStiUSD::SetNotificationHandle-Methode das Handle speichern und als Eingabeargument für SetEvent verwenden (siehe Microsoft Windows SDK Dokumentation). Der Treiber sollte SetEvent jedes Mal aufrufen, wenn ein Geräteereignis erkannt wird, um den Ereignismonitor darüber zu informieren, dass ein Ereignis aufgetreten ist.

Wenn hEventNULL ist, sollte die -Methode die Benachrichtigung über Geräteereignisse deaktivieren.

Anforderungen