Skip to content

Latest commit

 

History

History
31 lines (24 loc) · 1.42 KB

glitch-reporting-for-offloaded-audio.md

File metadata and controls

31 lines (24 loc) · 1.42 KB
Raw
title description ms.date
Glitch Reporting for Offloaded Audio
This topic explains the mechanism that an audio driver must use when it has to report glitching errors in connection with hardware-offloaded audio streams.
09/26/2023

Glitch Reporting for Offloaded Audio

This topic explains the mechanism that an audio driver must use when it has to report glitching errors in connection with hardware-offloaded audio streams.

When an audio driver detects glitching errors, it must raise an Event Tracing for Windows (ETW) event to report the errors. This event should include the reason for the glitch, along with information about the DMA buffer in use for the audio streams.

The following enum shows the events that have been defined for the audio driver to use for glitch error reporting.

typedef enum 
{
    eMINIPORT_IHV_DEFINED = 0, 
    eMINIPORT_BUFFER_COMPLETE,
    eMINIPORT_PIN_STATE,
    eMINIPORT_GET_STREAM_POS,
    eMINIPORT_SET_WAVERT_BUFFER_WRITE_POS,
    eMINIPORT_GET_PRESENTATION_POS,
    eMINIPORT_PROGRAM_DMA,
    eMINIPORT_GLITCH_REPORT
} EPcMiniportEngineEvent;

For more information about this enum, see EPcMiniportEngineEvent.

And for more information about how to develop a driver that can handle hardware-offloaded audio streams, see Hardware Offloaded Audio Driver Implementation.