PUNREGISTER_NOTIFICATION_CALLBACK Rückruffunktion (hdaudio.h)

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 Context-Element der HDAUDIO_BUS_INTERFACE_V3-Struktur an.

Handle

Behandeln, das das DMA-Modul identifiziert. Dieser Handlewert wurde aus einem vorherigen Aufruf von AllocateCaptureDmaEngine oder AllocateRenderDmaEngineabgerufen.

NotificationCallback

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

CallbackContext

Treiberspezifischer Kontextwert für die Rückrufroutine.

Rückgabewert

PUNREGISTER_NOTIFICATION_CALLBACK gibt STATUS_SUCCESS zurück, wenn der Aufruf die Registrierung des Benachrichtigungsereignisses erfolgreich aufgehoben hat. 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 Values.

Bemerkungen

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

Der HD-Audiobustreiber gibt den Verweis frei, der für den Treiber FDO verwendet wurde, als die Benachrichtigungsrückrufroutine zuvor registriert wurde.

Anforderungen

Siehe auch

PREGISTER_NOTIFICATION_CALLBACK

HDAUDIO_BUS_INTERFACE_V3

hdaudio.h