PUNREGISTER_EVENT_CALLBACK Rückruffunktion (hdaudio.h)

Artikel
02/26/2024

Die UnregisterEventCallback-Routine löscht die Registrierung eines Ereignisrückrufs, der zuvor durch einen Aufruf von RegisterEventCallback registriert wurde.

Der Funktionszeigertyp für eine UnregisterEventCallback-Routine ist 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-Element der HDAUDIO_BUS_INTERFACE-, HDAUDIO_BUS_INTERFACE_V2- oder 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 die Zustände der DMA-Engines ändert. Andernfalls gibt die Routine einen geeigneten Fehlercode zurück. Die folgende Tabelle zeigt eine mögliche Rückgabe status Code.

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

Hinweise

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.