KSPROPERTY_RTAUDIO_SETWRITEPACKET
KSPROPERTY_RTAUDIO_SETWRITEPACKET информирует драйвер о том, что ОС записала допустимые данные в буфер WaveRT.
Сводная таблица использования
| Получить | Присвойте параметру | Назначение | Тип дескриптора свойства | Тип значения свойства |
|---|---|---|---|---|
| Нет | Да | Pin | KSPROPERTY | KSRTAUDIO_SETWRITEPACKET_INFO |
Дескриптор свойства (данные экземпляра) является структурой KSPROPERTY . Перед отправкой запроса клиент загружает структуру со значениями, которые включают номер пакета, длину пакета и другие сведения.
Значение свойства представляет собой структуру типа KSRTAUDIO_SETWRITEPACKET_INFO.
Возвращаемое значение
Запрос свойства KSPROPERTY_RTAUDIO_SETWRITEPACKET возвращает STATUS_SUCCESS, указывающий на успешное выполнение. В противном случае запрос возвращает соответствующий код состояния сбоя.
Комментарии
Если этот KSPROPERTY поддерживается, драйвер может дополнительно использовать предоставленные сведения для оптимизации передачи оборудования. Например, драйвер может оптимизировать передачу DMA или программировать оборудование, чтобы остановить передачу в конце указанного пакета, если ОС не вызовет эту подпрограмму снова, чтобы сообщить драйверу о другом пакете. Это может уменьшить звуковые эффекты недостаточного потока, например, создать звуковой разрыв, а не повторять циклический буфер. Однако драйвер по-прежнему обязан увеличивать свой внутренний счетчик пакетов и сигнализировать события уведомлений в номинальном режиме реального времени.
За исключением случаев, когда ОС задает флаг KSSTREAM_HEADER_OPTIONSF_ENDOFSTREAM , размер пакета — это размер буфера WaveRT, разделенный на NotificationCount, передаваемого в KSPROPERTY_RTAUDIO_BUFFER_WITH_NOTIFICATION.
В зависимости от возможностей оборудования, если указан флаг KSSTREAM_HEADER_OPTIONSF_ENDOFSTREAM , драйвер может заполнить часть буфера WaveRT, следующую за пакетом EOS, в случае, если оборудование передает данные за пределы позиции EOS.
Требования
Версия |
Доступно в Windows 10 и более поздних версиях операционных систем Windows. |
Заголовок |
Ksmedia.h |