IDXCoreAdapterFactory::UnregisterEventNotification-Methode

  • Artikel
  • 2 Minuten Lesedauer

Hebt die Registrierung einer Benachrichtigung auf, für die Sie zuvor registriert sind. Programmieranleitungen und Codebeispiele finden Sie unter Verwenden von DXCore zum Aufzählen von Adaptern.

Syntax

virtual HRESULT STDMETHODCALLTYPE UnregisterEventNotification(
  uint32_t eventCookie) = 0;

Parameter

eventCookie

Typ: uint32_t

Der Cookiewert (zurückgegeben, wenn Sie IDXCoreAdapterFactory::RegisterEventNotification) genannt haben, der eine vorherige Registrierung darstellt, für die Sie jetzt die Registrierung aufheben möchten.

Gibt zurück

Typ: HRESULT

Wenn die Funktion erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein HRESULTerrorcode zurückgegeben.

Rückgabewert BESCHREIBUNG
E_INVALIDARG Der Wert von eventCookie ist kein gültiges Cookie, das eine vorherige Registrierung darstellt.

Bemerkungen

UnregisterEventNotification gibt nur zurück, nachdem alle ausstehenden/in-progress-Rückrufe für diese Registrierung abgeschlossen wurden. DXCore garantiert, dass keine neuen Rückrufe für diese Registrierung auftreten, nachdem UnregisterEventNotification zurückgegeben wurde. Um jedoch einen Deadlock zu vermeiden, wenn Sie "UnregisterEventNotification " aus Ihrem Rückruf aufrufen, wartet "UnregisterEventNotification " nicht, bis der aktive Rückruf abgeschlossen ist.

Wichtig

Bevor Sie das DXCore-Objekt zerstören, das durch das dxCoreObject-Argument dargestellt wird, das an IDXCoreAdapterFactory::RegisterEventNotification übergeben wird, müssen Sie den Cookiewert verwenden, um die Registrierung dieses Objekts aus Benachrichtigungen durch Aufrufen von UnregisterEventNotification zu aufheben. Wenn Sie dies nicht tun, wird eine schwerwiegende Ausnahme ausgelöst, wenn die Situation erkannt wird.

Nachdem Sie die Registrierung eines Cookiewerts aufgehoben haben, ist dieser Wert berechtigt, durch eine nachfolgende Registrierung zurückgegeben zu werden.

Weitere Informationen

IDXCoreAdapter, IDXCoreAdapterList, IDXCoreAdapterFactory::UnregisterEventNotification, DXCore Reference, Using DXCore to enumerate adapters