PREGISTER_NOTIFICATION_EVENT Rückruffunktion (hdaudio.h)

  • Artikel

Die RegisterNotificationEvent-Routine registriert ein Kernelereignis, damit es DMA-Statusbenachrichtigungen empfangen kann.

Der Funktionszeigertyp für eine RegisterNotificationEvent-Routine ist wie folgt definiert.

Syntax

PREGISTER_NOTIFICATION_EVENT PregisterNotificationEvent;

NTSTATUS PregisterNotificationEvent(
  [in] PVOID _context,
  [in] HANDLE Handle,
  [in] PKEVENT NotificationEvent
)
{...}

Parameter

[in] _context

Gibt den Kontextwert aus dem Context-Element der HDAUDIO_BUS_INTERFACE_V2-Struktur an.

[in] Handle

Handle, das die DMA-Engine identifiziert. Dieser Handlewert wurde aus einem vorherigen Aufruf von AllocateCaptureDmaEngine oder AllocateRenderDmaEngine abgerufen.

[in] NotificationEvent

Ein Zeiger auf ein Kernelereignis, das benachrichtigt werden muss, wenn DMA voranschreitet. Abhängig vom Benachrichtigungsanzahlparameter, der mit AllocateDmaBufferWithNotification verwendet wird, wird das registrierte Ereignis für jedes Mal, wenn der DMA den Audiopuffer durchläuft, ein- oder zweimal signalisiert.

Rückgabewert

RegisterNotificationEvent gibt STATUS_SUCCESS zurück, wenn der Aufruf das Ereignis erfolgreich registriert. Andernfalls gibt die Routine STATUS_INSUFFICIENT_RESOURCES zurück, um anzugeben, dass nicht genügend Ressourcen zum Abschließen des Vorgangs verfügbar sind.

Hinweise

RegisterNotificationEvent registriert ein Kernelereignis beim HD Audio Bus-Treiber. Der HD Audio Bus-Treiber verwaltet eine Liste mit registrierten Benachrichtigungsereignissen für jede DMA-Engine und signalisiert sie jedes Mal, wenn die Engine einen IOC-Interrupt empfängt. Ereignisse werden mithilfe von UnregisterNotificationEvent nicht registriert.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Verfügbar in Windows Vista und späteren Windows-Versionen.
Zielplattform Desktop
Kopfzeile hdaudio.h (hdaudio.h einschließen)
IRQL PASSIVE_LEVEL

Weitere Informationen

AllocateCaptureDmaEngine

AllocateDmaBufferWithNotification

AllocateRenderDmaEngine

HDAUDIO_BUS_INTERFACE_V2

UnregisterNotificationEvent