функция обратного вызова PUNREGISTER_NOTIFICATION_CALLBACK (hdaudio.h)

Функция обратного вызова PUNREGISTER_NOTIFICATION_CALLBACK удаляет регистрацию подпрограммы обратного вызова уведомления, которая ранее была зарегистрирована вызовом RegisterNotificationCallback.

Синтаксис

PUNREGISTER_NOTIFICATION_CALLBACK PunregisterNotificationCallback;

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

Параметры

_context

Задает значение контекста из элемента Контекста структуры HDAUDIO_BUS_INTERFACE_V3.

Handle

Дескриптор, определяющий подсистему DMA. Это значение дескриптора было получено из предыдущего вызова AllocateCaptureDmaEngine или AllocateRenderDmaEngine.

NotificationCallback

Подпрограмма обратного вызова, которая ранее была зарегистрирована для уведомления о ходе выполнения DMA с вызовом PREGISTER_NOTIFICATION_CALLBACK.

CallbackContext

Значение контекста для конкретного драйвера для подпрограммы обратного вызова.

Возвращаемое значение

PUNREGISTER_NOTIFICATION_CALLBACK возвращает STATUS_SUCCESS, если вызов успешно отменяет регистрацию события уведомления. В противном случае подпрограмма возвращает STATUS_INVALID_PARAMETER, чтобы указать, что указанная подпрограмма обратного вызова и контекст недопустимы.

Дополнительные сведения см. в значения NTSTATUS.

Замечания

PUNREGISTER_NOTIFICATION_CALLBACK будет использовать как NotificationCallback, так и CallbackContext, чтобы найти соответствующую ранее зарегистрированную подпрограмму обратного вызова для удаления.

Драйвер hd Audio bus отпустит ссылку, которую он взял на FDO драйвера, когда подпрограмма обратного вызова уведомления была зарегистрирована ранее.

Требования

См. также

PREGISTER_NOTIFICATION_CALLBACK

HDAUDIO_BUS_INTERFACE_V3

hdaudio.h