IDXCoreAdapterFactory::UnregisterEventNotification-Methode

Aufheben der Registrierung bei einer Benachrichtigung, für die Sie sich zuvor registriert haben. Programmieranleitungen und Codebeispiele finden Sie unter Using DXCore to enumerate adapters(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 beim Aufrufen von IDXCoreAdapterFactory::RegisterEventNotification),der eine vorherige Registrierung darstellt, für die Sie die Registrierung aufheben möchten.

Rückgabe

Typ: HRESULT

Wenn die Funktion erfolgreich ist, gibt sie S_OK. 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/in Bearbeitungen ausstehenden Rückrufe für diese Registrierung abgeschlossen wurden. DXCore garantiert, dass für diese Registrierung keine neuen Rückrufe erfolgen, nachdem UnregisterEventNotification zurückgegeben wurde. Wenn Sie jedoch UnregisterEventNotification innerhalb Ihres Rückrufs aufrufen, wartet UnregisterEventNotification nicht auf den Abschluss des aktiven Rückrufs, um einen Deadlock zu vermeiden.

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 bei Benachrichtigungen durch Aufrufen von UnregisterEventNotification 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, kann dieser Wert von einer nachfolgenden Registrierung zurückgegeben werden.

Weitere Informationen

IDXCoreAdapter, IDXCoreAdapterList, IDXCoreAdapterFactory::UnregisterEventNotification, DXCore-Referenz, Verwenden von DXCore zum Aufzählen von Adaptern