KSPROPERTY_RTAUDIO_UNREGISTER_NOTIFICATION_EVENT
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 |
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.
Requirements (Anforderungen)
Version |
Verfügbar in Windows Vista und höheren Windows-Betriebssystemen. |
Header |
Ksmedia.h |
Siehe auch
KSRTAUDIO_NOTIFICATION_EVENT_PROPERTY