IStiUSD::SetNotificationHandle-Methode (stiusd.h)

Die IStiUSD::SetNotificationHandle--Methode eines Stillbild-Minidrivers gibt einen Ereignishandle an, den der Minidriver verwenden soll, um den Aufrufer von Geräteereignissen zu informieren.

Syntax

HRESULT SetNotificationHandle(
  HANDLE hEvent
);

Parameter

hEvent

Vom Aufrufer bereitgestelltes Handle für ein Win32-Ereignis, das durch Aufrufen von CreateEventerstellt wird.

Rückgabewert

Wenn der Vorgang erfolgreich ist, sollte die Methode S_OK zurückgeben. Andernfalls sollte eine der STIERR-präfixierten Fehlercodes zurückgegeben werden, die in stierr.hdefiniert sind.

Bemerkungen

Wenn der Treiber (und das Gerät) eine asynchrone Benachrichtigung über Still Image Device Eventsunterstützt, ist die IStiUSD::SetNotificationHandle--Methode 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 zum SetEvent- verwenden (in der Microsoft Windows SDK-Dokumentation beschrieben). Der Treiber sollte SetEvent- jedes Mal aufrufen, wenn ein Geräteereignis erkannt wird, um den Ereignismonitor darüber zu benachrichtigen, dass ein Ereignis aufgetreten ist.

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

Anforderungen