KSPROPERTY_RTAUDIO_REGISTER_NOTIFICATION_EVENT
Die KSPROPERTY_RTAUDIO_REGISTER_NOTIFICATION_EVENT-Eigenschaft registriert ein Benutzermodusereignis für DMA-gesteuerte Ereignisbenachrichtigungen. Ereignisse müssen registriert werden, nachdem KSPROPERTY_RTAUDIO_BUFFER_WITH_NOTIFICATION erfolgreich aufgerufen wurde.
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_REGISTER_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 Benutzermodusereignisse für DMA-gesteuerte Ereignisbenachrichtigungen zu registrieren.
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 KSSTATERUN finden Sie im Thema Zustandsübergänge .
Nachdem Sie die Pin beendet haben, und vor dem Zeitpunkt, zu dem Sie sie schließen, wird die Registrierung jedes registrierten Ereignisses über einen Aufruf von KSPROPERTY_RTAUDIO_UNREGISTER_NOTIFICATION_EVENT aufgehoben.
Requirements (Anforderungen)
Version |
Verfügbar in Windows Vista und höheren Windows-Betriebssystemen. |
Header |
Ksmedia.h |
Siehe auch
KSPROPERTY_RTAUDIO_BUFFER_WITH_NOTIFICATION