PUNREGISTER_NOTIFICATION_CALLBACK Rückruffunktion (hdaudio.h)

Artikel
02/26/2024

Die PUNREGISTER_NOTIFICATION_CALLBACK Rückruffunktion löscht die Registrierung einer Benachrichtigungsrückrufroutine, die zuvor durch einen Aufruf von RegisterNotificationCallback registriert wurde.

Syntax

PUNREGISTER_NOTIFICATION_CALLBACK PunregisterNotificationCallback;

NTSTATUS PunregisterNotificationCallback(
  PVOID _context,
  HANDLE Handle,
  PHDAUDIO_DMA_NOTIFICATION_CALLBACK NotificationCallback,
  PVOID CallbackContext
)
{...}

Parameter

_context

Gibt den Kontextwert aus dem Kontextelement der HDAUDIO_BUS_INTERFACE_V3-Struktur an.

Handle

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

NotificationCallback

Eine Rückrufroutine, die zuvor für die DMA-Statusbenachrichtigung mit einem Aufruf von PREGISTER_NOTIFICATION_CALLBACK registriert wurde.

CallbackContext

Treiberspezifischer Kontextwert für die Rückrufroutine.

Rückgabewert

PUNREGISTER_NOTIFICATION_CALLBACK gibt STATUS_SUCCESS zurück, wenn die Registrierung des Benachrichtigungsereignisses durch den Aufruf erfolgreich aufgehoben wird. Andernfalls gibt die Routine STATUS_INVALID_PARAMETER zurück, um anzugeben, dass die angegebene Rückrufroutine und der angegebene Kontext ungültig sind.

Weitere Informationen finden Sie unter NTSTATUS-Werte.

Hinweise

PUNREGISTER_NOTIFICATION_CALLBACK verwenden sowohl NotificationCallback als auch CallbackContext, um die übereinstimmende zuvor registrierte Rückrufroutine zu finden, die entfernt werden soll.

Der HD Audio Bus-Treiber gibt den Verweis auf die Treiber-FDO frei, als die Benachrichtigungsrückrufroutine zuvor registriert wurde.