KSPROPERTY_RTAUDIO_GETREADPACKET
KSPROPERTY_RTAUDIO_GETREADPACKET возвращает сведения о захваченных аудиопакетах.
Сводная таблица использования
| Получить | Присвойте параметру | Назначение | Тип дескриптора свойства | Тип значения свойства |
|---|---|---|---|---|
| Да | Нет | Pin | KSPROPERTY | KSRTAUDIO_GETREADPACKET_INFO |
Дескриптор свойства (данные экземпляра) является структурой KSPROPERTY . Перед отправкой запроса клиент загружает структуру со значениями, указывающими номер пакета, длину пакета и другие сведения.
Значение свойства — это переменная типа KSRTAUDIO_GETREADPACKET_INFO.
Возвращаемое значение
Запрос свойства KSPROPERTY_RTAUDIO_GETREADPACKET возвращает STATUS_SUCCESS, указывающий на успешное выполнение. В противном случае запрос возвращает соответствующий код состояния сбоя.
STATUS_DEVICE_NOT_READY — драйвер возвращает эту ошибку, если нет новых данных.
Комментарии
Перед чтением захваченных звуковых данных из буфера WaveRT ОС вызывает эту подпрограмму для получения сведений о доступных данных.
Номер пакета идентифицирует пакет в потоке. При этом при KSSTATE_STOP поток сбрасывается до нуля. Число перемещается с каждым захваченным буфером. Из номера пакета ОС может наследовать расположение пакета в буфере WaveRT, а также наследовать позицию потока пакета относительно начала потока.
Размер пакета — это размер буфера WaveRT, разделенный на значение NotificationCount, переданное в KSPROPERTY_RTAUDIO_BUFFER_WITH_NOTIFICATION. Операционная система может вызвать эту подпрограмму в любое время. В обычной работе ОС вызывает эту подпрограмму после установки драйвером события уведомления буфера или после того, как предыдущий вызов возвращает значение true для MoreData. Когда ОС вызывает эту подпрограмму, драйвер может предположить, что ОС закончила чтение всех предыдущих пакетов. Если оборудование захватило достаточно данных, драйвер может немедленно пришвырнуть следующий полный пакет в буфер WaveRT и снова установить событие буфера. В случае переполнения записи (когда ОС недостаточно быстро считывает данные) звуковой драйвер может удалить или перезаписать некоторые звуковые данные. Аудиодрайвер сначала удаляет или перезаписывает самые старые данные. Аудиодрайвер может продолжать продвигать свой внутренний счетчик пакетов, даже если ОС может не прочитать данные.
Требования
Версия |
Доступно в Windows 10 и более поздних операционных системах Windows. |
Заголовок |
Ksmedia.h |