IDXCoreAdapterFactory::UnregisterEventNotification-Methode

Hebt die Registrierung einer Benachrichtigung auf, für die Sie sich zuvor registriert haben. Programmieranleitungen und Codebeispiele finden Sie unter Verwenden von DXCore zum Auflisten von Adaptern.

Syntax

virtual HRESULT STDMETHODCALLTYPE UnregisterEventNotification(
  uint32_t eventCookie) = 0;

Parameter

eventCookie

Typ: uint32_t

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

Gibt zurück

Typ: HRESULT

Wenn die Funktion erfolgreich ist, gibt sie S_OK zurück. Andernfalls wird ein HRESULT-Fehlercode zurückgegeben.

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

Bemerkungen

UnregisterEventNotification wird erst zurückgegeben, nachdem alle ausstehenden/laufenden Rückrufe für diese Registrierung abgeschlossen sind. DXCore garantiert, dass keine neuen Rückrufe für diese Registrierung erfolgen, nachdem UnregisterEventNotification zurückgegeben wurde. Um jedoch einen Deadlock zu vermeiden, wartet UnregisterEventNotification nicht, bis der aktive Rückruf abgeschlossen ist, wenn Sie UnregisterEventNotification in Ihrem Rückruf aufrufen.

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 aufzuheben, indem Sie UnregisterEventNotification aufrufen. Wenn Sie dies nicht tun, wird eine schwerwiegende Ausnahme ausgelöst, wenn die Situation erkannt wird.

Nachdem Sie die Registrierung eines Cookiewerts aufgehoben haben, kann dieser Wert von einer nachfolgenden Registrierung zurückgegeben werden.

Weitere Informationen

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