функция обратного вызова 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

Задает значение контекста из элемента 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 освободит ссылку на FDO драйвера, когда ранее была зарегистрирована процедура обратного вызова уведомлений.

Требования

Требование Значение
Минимальная версия клиента 19H1
Верхняя часть hdaudio.h
IRQL PASSIVE_LEVEL

См. также раздел

PREGISTER_NOTIFICATION_CALLBACK

HDAUDIO_BUS_INTERFACE_V3

hdaudio.h