已卸载音频的故障报告

本主题介绍音频驱动程序在必须报告与硬件卸载音频流相关的故障错误时必须使用的机制。

当音频驱动程序检测到故障错误时，它必须引发 Windows 事件跟踪 (ETW) 事件来报告错误。 此事件应包括故障的原因，以及有关用于音频流的 DMA 缓冲区的信息。

以下枚举显示已为音频驱动程序定义的事件，这些事件用于故障错误报告。

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;

有关此枚举的详细信息，请参阅 EPcMiniportEngineEvent。

有关如何开发可处理硬件卸载音频流的驱动程序的详细信息，请参阅硬件卸载音频驱动程序实现。