KSPROPERTY_RTAUDIO_UNREGISTER_NOTIFICATION_EVENT

Artikel
06/15/2023

Die KSPROPERTY_RTAUDIO_UNREGISTER_NOTIFICATION_EVENT-Eigenschaft hebt die Registrierung eines Benutzermodusereignisses bei DMA-gesteuerten Ereignisbenachrichtigungen auf.

In der folgenden Tabelle sind die Features dieser Eigenschaft zusammengefasst.

Nutzungszusammenfassungstabelle

Herunterladen	Set	Ziel	Eigenschaftendeskriptortyp	Eigenschaftswerttyp
Ja	Ja	Pin	KSRTAUDIO_NOTIFICATION_EVENT_PROPERTY	NULL

Der Eigenschaftendeskriptor (instance Daten) besteht aus einer KSRTAUDIO_NOTIFICATION_EVENT_PROPERTY-Struktur, die eine KSPROPERTY-Struktur zusammen mit einem Ereignishandle im Benutzermodus enthält.

Der Eigenschaftswert (Vorgangsdaten) für diese Eigenschaft ist NULL , da keine Vorgangsdaten zurückgegeben werden.

Rückgabewert

Eine KSPROPERTY_ RTAUDIO_UNREGISTER_NOTIFICATION_EVENT-Eigenschaftsanforderung gibt STATUS_SUCCESS zurück, um anzugeben, dass sie erfolgreich abgeschlossen wurde. Andernfalls gibt die Anforderung einen geeigneten Fehler status Code zurück. In der folgenden Tabelle sind einige der möglichen Fehler status Codes aufgeführt.

Statuscode	Bedeutung
STATUS_NOT_SUPPORTED	Ereignisbenachrichtigungen werden nicht unterstützt.
STATUS_INSUFFICIENT_RESOURCES	Arbeitsspeicher für den Puffer kann nicht zugeordnet werden.
STATUS_DEVICE_NOT_READY	Das Gerät ist nicht bereit.

Bemerkungen

Diese Eigenschaft wird verwendet, um die Registrierung von Benutzermodusereignissen bei DMA-gesteuerten Ereignisbenachrichtigungen aufzuheben.

Wenn der Pin in den Ausführungszustand (KSSTATE_RUN) versetzt wird, werden die registrierten Ereignisse ein- oder zweimal pro Zyklus des zyklischen Audiopuffers signalisiert, je nachdem, wie viele Benachrichtigungen beim Aufruf KSPROPERTY_RTAUDIO_BUFFER_WITH_NOTIFICATION angefordert wurden. Weitere Informationen zu KSSTATE_RUN finden Sie im Thema Zustandsübergänge .

Nachdem Sie die Pin beendet haben und vor dem Schritt, in dem Sie sie schließen, muss die Registrierung jedes registrierten Ereignisses über einen Aufruf von KSPROPERTY_RTAUDIO_UNREGISTER_NOTIFICATION_EVENT aufgehoben werden.