PUNREGISTER_NOTIFICATION_CALLBACK fonction de rappel (hdaudio.h)

Article
02/29/2024

La fonction de rappel PUNREGISTER_NOTIFICATION_CALLBACK supprime l’inscription d’une routine de rappel de notification précédemment inscrite par un appel à RegisterNotificationCallback.

Syntaxe

PUNREGISTER_NOTIFICATION_CALLBACK PunregisterNotificationCallback;

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

Paramètres

_context

Spécifie la valeur de contexte du membre Context de la structure HDAUDIO_BUS_INTERFACE_V3 .

Handle

Handle qui identifie le moteur DMA. Cette valeur de handle a été obtenue à partir d’un appel précédent à AllocateCaptureDmaEngine ou AllocateRenderDmaEngine.

NotificationCallback

Routine de rappel précédemment inscrite pour la notification de progression DMA avec un appel à PREGISTER_NOTIFICATION_CALLBACK.

CallbackContext

Valeur de contexte spécifique au pilote pour la routine de rappel.

Valeur retournée

PUNREGISTER_NOTIFICATION_CALLBACK retourne STATUS_SUCCESS si l’appel annule l’inscription de l’événement de notification. Sinon, la routine retourne STATUS_INVALID_PARAMETER pour indiquer que la routine de rappel et le contexte spécifiés ne sont pas valides.

Pour plus d’informations, consultez Valeurs NTSTATUS.

Remarques

PUNREGISTER_NOTIFICATION_CALLBACK utiliserez à la fois NotificationCallback et CallbackContext pour trouver la routine de rappel correspondante précédemment inscrite à supprimer.

Le pilote de bus Audio HD libère la référence qu’il a prise sur le FDO du pilote lorsque la routine de rappel de notification a été enregistrée précédemment.