KSEVENT_PINCAPS_FORMATCHANGE

项目
03/05/2024

KSEVENT_PINCAPS_FORMATCHANGE 事件向音频堆栈指示音频设备的音频数据格式已更改。

使用情况摘要表

目标	事件描述符类型	事件值类型
固定	KSEVENT	KSEVENTDATA

事件值类型（操作数据）是 KSEVENTDATA 结构，它指定要用于此事件的通知方法。

注解

当音频端口驱动程序为其微型端口驱动程序调用 EventHandler 例程时，它将传递 PCEVENT_REQUEST 结构。此结构包含指向 PCEVENT_ITEM 结构的指针，该结构用于描述筛选器、引脚或节点支持的事件。

因此，例如，支持 KSEVENT_PINCAPS_FORMATCHANGE 事件的驱动程序必须填充 PCEVENT_ITEM 结构，如下所示：

static PCEVENT_ITEM FormatChangePinEvent[] = {
  {
    &KSEVENTSETID_PinCapsChange,
    KSEVENT_PINCAPS_FORMATCHANGE,
    KSEVENT_TYPE_ENABLE | KSEVENT_TYPE_BASICSUPPORT,
    MyEventHandler
  }
};

在前面的代码示例中，MyEventHandler 自定义事件处理程序必须监视 KSEVENT_PINCAPS_FORMATCHANGE 事件，并在触发 KSEVENT_PINCAPS_FORMATCHANGE 时将其注册到 Portcls。微型端口驱动程序必须调用 IPortEvents::AddEventToEventList 方法来注册事件。

若要获取微型端口驱动程序支持的引脚、节点、连接和属性的说明，端口驱动程序会调用 IMiniport::GetDescription 方法。此方法调用会返回指向自动化表 (PCAUTOMATION_TABLE) 的 PCFILTER_DESCRIPTOR 结构。 PCAUTOMATION_TABLE 结构具有 Events 成员。此成员指向与微型端口驱动程序支持的筛选器关联的事件的数组。因此，必须将 Events 成员设置为指向包含 KSEVENT_PINCAPS_FORMATCHANGE 事件的 PCEVENT_ITEM 结构的事件数组。

当微型端口驱动程序检测到动态格式更改时，它必须调用 IPortEvents::GenerateEventList 方法来向 KSEVENT_PINCAPS_FORMATCHANGE 事件发出信号。