EPcMiniportEngineEvent 枚举 (portcls.h)

本主题介绍 EPcMiniportEngineEvent 枚举，并介绍在微型端口驱动程序报告故障错误时提供其他信息的参数。

以下枚举中的事件 ID 表示微型端口驱动程序可以通过端口类驱动程序 (PortCls) 使用回调报告的事件。

语法

typedef enum {
  eMINIPORT_IHV_DEFINED,
  eMINIPORT_BUFFER_COMPLETE,
  eMINIPORT_PIN_STATE,
  eMINIPORT_GET_STREAM_POSITION,
  eMINIPORT_SET_WAVERT_BUFFER_WRITE_POSITION,
  eMINIPORT_GET_PRESENTATION_POSITION,
  eMINIPORT_PROGRAM_DMA,
  eMINIPORT_GLITCH_REPORT,
  eMINIPORT_LAST_BUFFER_RENDERED,
  eMINIPORT_PROCESSING_MODE,
  eMINIPORT_FX_CLSID,
  eMINIPORT_MaxValue
} EPcMiniportEngineEvent;

常量

eMINIPORT_IHV_DEFINED 指定 IHV 定义的事件的 ID。
eMINIPORT_BUFFER_COMPLETE 指定缓冲区完成事件的 ID。
eMINIPORT_PIN_STATE 指定与固定状态更改相关的事件的 ID。
eMINIPORT_GET_STREAM_POSITION 指定“获取流位置”事件的 ID。
eMINIPORT_SET_WAVERT_BUFFER_WRITE_POSITION 指定“波形缓冲区写入位置”事件的 ID。
eMINIPORT_GET_PRESENTATION_POSITION 指定“获取演示文稿位置”事件的 ID。
eMINIPORT_PROGRAM_DMA 指定“程序 DMA”事件的 ID。
eMINIPORT_GLITCH_REPORT 指定“故障报告”事件的 ID。
eMINIPORT_LAST_BUFFER_RENDERED 指定呈现的最后一个缓冲区的 ID。
eMINIPORT_PROCESSING_MODE 指定故障发生时生效的处理模式的 ID。
eMINIPORT_FX_CLSID 指定发生故障时生效的音频处理效果 (FX) 的类 ID。
eMINIPORT_MaxValue 指定用于报告故障的最高枚举值的 ID。

注解

下表显示了随 Windows 8 引入的 EPcMiniportEngineEvent 枚举的成员。 该表显示与枚举成员关联的事件及其参数的含义。

事件类型	参数 1	参数 2	参数 3	参数 4
特定于 IHV 的事件类型。	由 IHV 定义和使用。	由 IHV 定义和使用。	由 IHV 定义和使用。	由 IHV 定义和使用。
缓冲区完成。	当前线性缓冲区位置。	当前 WaveRTBuffer 写入位置。	已完成的数据长度。	0
固定状态。	当前线性缓冲区位置。	当前 WaveRTBuffer 写入位置。	0 - KS_STOP 1 - KS_ACQUIRE 2 - KS_PAUSE 3 - KS_RUN	0
获取流位置。	当前线性缓冲区位置。	当前 WaveRTBuffer 写入位置。	0	0
设置 WaveRT 缓冲区写入位置。	当前线性缓冲区位置。	从 PortCl 接收的当前 WaveRTBuffer 写入位置。	从 PortCl 接收的目标 WaveRTBuffer 写入位置。	0
获取演示文稿位置。	当前线性缓冲区位置。	当前 WaveRTBuffer 写入位置。	演示文稿位置。	0
程序 DMA。	当前线性缓冲区位置。	当前 WaveRTBuffer 写入位置。	起始 WaveRtBuffer 偏移量	数据长度。
故障检测。	当前线性缓冲区位置。	当前 WaveRTBuffer 写入位置。	1 - 运行的 WaveRT 缓冲区 2 - 解码器错误 3 - 在一行中接收相同的 WaveRT 缓冲区写入位置两次。	当参数 3 = “3”时，参数 4 是有问题的写入位置。

 

下表显示了随 Windows 8.1 引入的 EPcMiniportEngineEvent 枚举的成员。 该表显示与枚举成员关联的事件及其参数的含义。

事件类型	参数 1	参数 2	参数 3	参数 4
上次呈现的缓冲区。	当前线性缓冲区位置。	驱动程序收到的最后一个 WaveRtBuffer 写入位置。	0	0
处理模式。	当前线性缓冲区位置。	当前 WaveRTBuffer 写入位置。	GUID 的前 8 个字节。	第二个 8 个字节的 GUID。
FX 类 ID。	当前线性缓冲区位置。	当前 WaveRTBuffer 写入位置。	FX CLSID 的前 8 个字节。	后 8 个字节的 FX CLSID。
最大值。	枚举值的 ID。	0	0	0

要求

要求	值
最低受支持的客户端	Windows 8
最低受支持的服务器	Windows Server 2012
标头	portcls.h

另请参阅

已卸载音频的故障报告

MiniportWriteEtwEvent