PUNREGISTER_EVENT_CALLBACK Rückruffunktion (hdaudio.h)

Artikel
02/07/2025

Die UnregisterEventCallback Routine löscht die Registrierung eines Ereignisrückrufs, der zuvor von einem Aufruf an RegisterEventCallbackregistriert wurde.

Der Funktionszeigertyp für eine UnregisterEventCallback- Routine wird wie folgt definiert.

Syntax

PUNREGISTER_EVENT_CALLBACK PunregisterEventCallback;

NTSTATUS PunregisterEventCallback(
  [in] PVOID _context,
  [in] UCHAR Tag
)
{...}

Parameter

[in] _context

Gibt den Kontextwert aus dem Context Member der HDAUDIO_BUS_INTERFACE, HDAUDIO_BUS_INTERFACE_V2oder HDAUDIO_BUS_INTERFACE_BDL Struktur an.

[in] Tag

Gibt den Tagwert an, der dem Rückruf durch den vorherigen Aufruf von RegisterEventCallback-zugeordnet wurde.

Rückgabewert

UnregisterEventCallback- gibt STATUS_SUCCESS zurück, wenn der Aufruf erfolgreich ist, die Zustände der DMA-Engines zu ändern. Andernfalls gibt die Routine einen geeigneten Fehlercode zurück. Die folgende Tabelle zeigt einen möglichen Rückgabestatuscode.

Rückgabecode	Beschreibung
STATUS_INVALID_PARAMETER	Gibt an, dass das angegebene Tag ungültig ist.

Bemerkungen

Vor dem Aufrufen dieser Routine ist der Funktionstreiber für die Programmierung des Codecs oder Codecs verantwortlich, um die Zuordnung des Rückrufs mit dem angegebenen Tag zu entfernen.