KSPROPERTY_RTAUDIO_UNREGISTER_NOTIFICATION_EVENT
Свойство KSPROPERTY_RTAUDIO_UNREGISTER_NOTIFICATION_EVENT отменяет регистрацию события пользовательского режима из уведомления о событиях на основе DMA.
В следующей таблице перечислены функции этого свойства.
Сводная таблица использования
| Получить | Присвойте параметру | Назначение | Тип дескриптора свойства | Тип значения свойства |
|---|---|---|---|---|
Да |
Да |
Pin |
NULL |
Дескриптор свойства (данные экземпляра) состоит из структуры KSRTAUDIO_NOTIFICATION_EVENT_PROPERTY, содержащей структуру KSPROPERTY вместе с дескриптором событий пользовательского режима.
Значение свойства (данные операции) для этого свойства равно NULL , так как данные операции не возвращаются.
Возвращаемое значение
Запрос свойства KSPROPERTY_ RTAUDIO_UNREGISTER_NOTIFICATION_EVENT возвращает STATUS_SUCCESS, указывающий на успешное выполнение. В противном случае запрос возвращает соответствующий код состояния сбоя. В следующей таблице показаны некоторые возможные коды состояния сбоя.
| Код состояния | Значение |
|---|---|
STATUS_NOT_SUPPORTED |
Уведомления о событиях не поддерживаются. |
STATUS_INSUFFICIENT_RESOURCES |
Память для буфера не может быть выделена. |
STATUS_DEVICE_NOT_READY |
Устройство не готово. |
Комментарии
Это свойство используется для отмены регистрации событий пользовательского режима из уведомления о событиях на основе DMA.
Когда закрепление помещается в состояние выполнения (KSSTATE_RUN), зарегистрированные события получают сигнал один или два раза за цикл циклического звукового буфера в зависимости от количества уведомлений, запрошенных при вызове KSPROPERTY_RTAUDIO_BUFFER_WITH_NOTIFICATION . Дополнительные сведения о KSSTATE_RUN см. в разделе Переходы состояния .
После остановки закрепления и до завершения шага каждое зарегистрированное событие должно быть отменено с помощью вызова KSPROPERTY_RTAUDIO_UNREGISTER_NOTIFICATION_EVENT.
Требования
Версия |
Доступно в Операционных системах Windows Vista и более поздних версий. |
Заголовок |
Ksmedia.h |
См. также
KSRTAUDIO_NOTIFICATION_EVENT_PROPERTY