KSPROPERTY_RTAUDIO_REGISTER_NOTIFICATION_EVENT

Свойство KSPROPERTY_RTAUDIO_REGISTER_NOTIFICATION_EVENT регистрирует событие пользовательского режима для уведомления о событиях на основе DMA. События должны быть зарегистрированы после успешного вызова KSPROPERTY_RTAUDIO_BUFFER_WITH_NOTIFICATION.

В следующей таблице перечислены функции этого свойства.

Сводная таблица использования

Получить	Присвойте параметру	Назначение	Тип дескриптора свойства	Тип значения свойства
Да	Да	Pin	KSRTAUDIO_NOTIFICATION_EVENT_PROPERTY	NULL

Дескриптор свойства (данные экземпляра) состоит из структуры KSRTAUDIO_NOTIFICATION_EVENT_PROPERTY, содержащей структуру KSPROPERTY вместе с дескриптором событий пользовательского режима.

Значение свойства (данные операции) для этого свойства равно NULL , так как данные операции не возвращаются.

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

Запрос свойства KSPROPERTY_ RTAUDIO_REGISTER_NOTIFICATION_EVENT возвращает STATUS_SUCCESS, указывающий на успешное выполнение. В противном случае запрос возвращает соответствующий код состояния сбоя. В следующей таблице показаны некоторые возможные коды состояния сбоя.

Код состояния	Значение
STATUS_NOT_SUPPORTED	Уведомления о событиях не поддерживаются.
STATUS_INSUFFICIENT_RESOURCES	Память для буфера не может быть выделена.
STATUS_DEVICE_NOT_READY	Устройство не готово.

Комментарии

Это свойство используется для регистрации событий пользовательского режима для уведомления о событиях на основе DMA.

Когда закрепление помещается в состояние выполнения (KSSTATE_RUN), зарегистрированные события сигналит один или два раза за цикл циклического звукового буфера в зависимости от количества уведомлений, запрошенных при вызове KSPROPERTY_RTAUDIO_BUFFER_WITH_NOTIFICATION. Дополнительные сведения о KSSTATERUN см. в разделе Переходы состояния .

После остановки закрепления и до момента его закрытия каждое зарегистрированное событие отменяется с помощью вызова KSPROPERTY_RTAUDIO_UNREGISTER_NOTIFICATION_EVENT.

Требования

Версия	Доступно в Операционных системах Windows Vista и более поздних версий.
Заголовок	Ksmedia.h

См. также

KSPROPERTY

KSPROPERTY_RTAUDIO_BUFFER_WITH_NOTIFICATION

KSPROPERTY_RTAUDIO_UNREGISTER_NOTIFICATION_EVENT

Переходы состояния