функция обратного вызова 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 поддерживает список зарегистрированных событий уведомлений для каждого обработчика DMA и сообщает им каждый раз, когда обработчик получает прерывание IOC. События отменяются с помощью UnregisterNotificationEvent.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Доступно в Windows Vista и более поздних версиях Windows. |
| целевая платформа | Настольный |
| заголовка | hdaudio.h (include Hdaudio.h) |
| IRQL | PASSIVE_LEVEL |