IMiniportWaveRTStreamNotification::RegisterNotificationEvent-Methode (portcls.h)

Die RegisterNotificationEvent -Methode registriert ein Ereignis, das für DMA-gesteuerte Ereignisbenachrichtigungen benachrichtigt werden soll.

Syntax

NTSTATUS RegisterNotificationEvent(
  [in] PKEVENT NotificationEvent
);

Parameter

[in] NotificationEvent

Ein Zeiger auf ein Kernelereignis (PKEVENT), das für die Benachrichtigung registriert werden soll, wenn DMA fortschreitet.

Rückgabewert

RegisterNotificationEventgibt einen status Wert von STATUS_SUCCESS zurück, wenn der Aufruf erfolgreich war. Andernfalls gibt die Methode einen entsprechenden Fehler status Code zurück.

Hinweise

Der Porttreiber ruft diese Methode als Antwort auf eine KSPROPERTY_RTAUDIO_REGISTER_NOTIFICATION_EVENT-Eigenschaftsanforderung von einem Client auf. Der Porttreiber ordnet das Benutzermodusereignishandle einem Kernelereigniszeiger zu und übergibt den Zeiger mit dem NotificationEvent-Parameter .

Wenn DMA-gesteuerte Ereignisbenachrichtigungen aktiviert sind, wird die DMA-Hardware in der Regel so programmiert, dass Hardwareunterbrechungen an den vorgesehenen Benachrichtigungspunkten im zyklischen Audiopuffer generiert werden. Wenn die Treiberunterbrechungsdienstroutine (ISR) diesen Interrupt erkennt, wird ein verzögerter Prozeduraufruf (DPC) in die Warteschlange gestellt. Der DPC wiederum signalisiert jedes registrierte Ereignis. Es wird empfohlen, ein try/except-Konstrukt um das Ereignis herum zu verwenden, das den Aufruf signalisiert.

Weitere Informationen zum Verhalten der KSPROPERTY_RTAUDIO_REGISTER_NOTIFICATION_EVENT-Eigenschaft finden Sie im KSRTAUDIO_NOTIFICATION_EVENT_PROPERTY.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar unter Windows Vista und höheren Windows-Betriebssystemen.
Zielplattform	Universell
Header	portcls.h
IRQL	Passive Ebene.

Weitere Informationen

IMiniportWaveRTStreamNotification

KSPROPERTY_RTAUDIO_REGISTER_NOTIFICATION_EVENT

KSRTAUDIO_NOTIFICATION_EVENT_PROPERTY