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

  • Статья

Подпрограмма RegisterNotificationEvent регистрирует событие ядра, чтобы получать уведомления о ходе выполнения DMA.

Тип указателя функции для подпрограммы RegisterNotificationEvent определяется следующим образом.

Синтаксис

PREGISTER_NOTIFICATION_EVENT PregisterNotificationEvent;

NTSTATUS PregisterNotificationEvent(
  [in] PVOID _context,
  [in] HANDLE Handle,
  [in] PKEVENT NotificationEvent
)
{...}

Параметры

[in] _context

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

[in] Handle

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

[in] NotificationEvent

Указатель на событие ядра, которое должно быть уведомлено по мере выполнения DMA. В зависимости от параметра числа уведомлений, используемого с AllocateDmaBufferWithNotification, зарегистрированное событие передается один или два раза за каждый раз, когда DMA проходит через звуковой буфер.

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

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

Комментарии

RegisterNotificationEvent регистрирует событие ядра с помощью драйвера шины HD Audio. Драйвер шины HD Audio ведет список зарегистрированных событий уведомлений для каждого обработчика DMA и сообщает о них каждый раз, когда подсистема получает прерывание IOC. События отменяются с помощью unregisterNotificationEvent.

Требования

Требование Значение
Минимальная версия клиента Доступно в Windows Vista и более поздних версиях Windows.
Целевая платформа Персональный компьютер
Верхняя часть hdaudio.h (включая Hdaudio.h)
IRQL PASSIVE_LEVEL

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

AllocateCaptureDmaEngine

AllocateDmaBufferWithNotification

AllocateRenderDmaEngine

HDAUDIO_BUS_INTERFACE_V2

UnregisterNotificationEvent