portcls.h 标头

音频使用此标头。 有关详细信息，请参阅：

• 音频：

portcls.h 包含以下编程接口：

接口

IAdapterPnpManagement IAdapterPnpManagement 是适配器在想要接收 PnP 管理消息时应实现和注册的接口。
IAdapterPowerManagement IAdapterPowerManagement 接口用于管理音频适配器的电源状态。
IAdapterPowerManagement2 IAdapterPowerManagement2 接口继承自 IUnknown，用于管理音频适配器的电源状态。
IAdapterPowerManagement3 IAdapterPowerManagement3 接口继承自 IUnknown，用于接收电源管理消息。
IDmaChannel IDmaChannel 接口提供 DMA 通道及其关联的 DMA 缓冲区和用法参数的抽象。
IDmaChannelSlave IDmaChannelSlave 接口提供用于监视和控制从属设备 (的 DMA 通道的方法，如适配器对象简介) 中所述。
IDrmPort IDrmPort 接口由 WaveCyclic 或 WavePci 微型端口驱动程序用于管理受 DRM 保护的内容， (请参阅数字版权管理) 。
IDrmPort2 IDrmPort2 接口由 WaveCyclic 或 WavePci 微型端口驱动程序用于管理受 DRM 保护的内容， (请参阅数字版权管理) 。
IInterruptSync IInterruptSync 接口表示一个中断同步对象，该对象 (ISR) 非 ISR 例程同步中断服务例程列表的执行。
IMiniport IMiniport 接口是所有微型端口对象支持的通用微型端口接口。 IMiniport 继承自 IUnknown 接口。
IMiniportAudioEngineNode 此接口允许微型端口驱动程序使用通过 KS 筛选器句柄访问音频引擎的 KS 属性。
IMiniportAudioSignalProcessing IMiniportAudioSignalProcessing 接口由任何音频驱动程序的 WaveRT 微型端口组件实现（如果其任何引脚支持音频信号处理模式）。
IMiniportMidi IMiniportMidi 接口是 MIDI 合成器设备的 MIDI 微型端口驱动程序的主接口。
IMiniportMidiStream IMiniportMidiStream 接口表示通过 MIDI 筛选器上的引脚流动的 MIDI 流。
IMiniportPnpNotify IMiniportPnpNotify 是一个可选接口，允许微型端口对象 (音频子设备) 接收 PnP 状态更改通知。
IMiniportStreamAudioEngineNode 此接口允许微型端口驱动程序使用 KS 属性，这些属性通过固定实例句柄访问音频引擎。
IMiniportStreamAudioEngineNode2 IMiniportStreamAudioEngineNode2 接口允许音频微型端口驱动程序扩展 IMiniportStreamAudioEngineNode 接口的功能。
IMiniportTopology IMiniportTopology 接口是拓扑微型端口驱动程序的主接口。
IMiniportWaveCyclic IMiniportWaveCyclic 接口是由 WaveCyclic 音频设备的微型端口驱动程序公开的主接口。
IMiniportWaveCyclicStream IMiniportWaveCyclicStream 接口表示流经 WaveCyclic 筛选器上的引脚的波流。
IMiniportWavePci IMiniportWavePci 接口是由 WavePci 音频设备的微型端口驱动程序公开的主接口。
IMiniportWavePciStream IMiniportWavePciStream 接口表示流经 WavePci 筛选器上的引脚的波流。
IMiniportWaveRT IMiniportWaveRT 接口是由 WaveRT 音频设备的微型端口驱动程序公开的主接口。
IMiniportWaveRTInputStream IMiniportWaveRTInputStream 接口表示通过包装 WaveRT 呈现或捕获设备的 KS 筛选器上的引脚流动的输入波流。 IMiniportWaveRTInputStream 继承自 IUnknown 接口。
IMiniportWaveRTOutputStream IMiniportWaveRTOutputStream 接口表示输出波流。 IMiniportWaveRTOutputStream 继承自 IUnknown 接口。
IMiniportWaveRTStream IMiniportWaveRTStream 接口表示流经包装 WaveRT 呈现或捕获设备的 KS 筛选器上的引脚的波流。
IMiniportWaveRTStreamNotification IMiniportWaveRTStreamNotification 接口在 Windows Vista 和更高版本的 Windows 操作系统中受支持，它扩充了 IMiniportWaveRTStream 接口，提供了其他方法来促进 DMA 驱动程序事件通知。
IMusicTechnology IMusicTechnology 接口用于更改属于 MIDI 或 DMus 微型端口驱动程序的引脚的数据范围描述符中指定的音乐技术 GUID。
IPinCount IPinCount 接口为微型端口驱动程序提供了一种在引脚实例化和关闭时动态监视和操作其引脚计数的方法。
IPinName 在 Windows 7 及更高版本的操作系统中，微型端口驱动程序使用 IPinName 接口来报告和更新音频终结点的名称。
IPort IPort 接口是音频端口驱动程序的通用接口。 所有音频端口驱动程序都公开 IPort 作为其下边缘的一部分。 适配器驱动程序在此接口上调用初始化方法。 IPort 继承自 IUnknown 接口。
IPortClsEtwHelper IPortClsEtwHelper 接口允许音频微型端口驱动程序访问 Windows 事件跟踪 (ETW) 帮助程序函数。
IPortClsNotifications 端口实现的接口，为微型端口提供通知帮助程序以支持音频模块通信。
IPortClsPnp IPortClsPnp 是端口类驱动程序 (PortCls) 向适配器公开的 PnP 管理接口。
IPortClsPower Windows Vista 和更高版本的 Windows 支持 IPortClsPower 接口。 IPortClsPower 是端口类驱动程序 (PortCls) 向适配器公开的电源管理接口。
IPortClsRuntimePower IPortClsRuntimePower 是端口类驱动程序 (PortCls) 用于访问音频适配器的运行时电源管理功能的接口。
IPortClsStreamResourceManager IPortClsStreamResourceManager 用于管理音频流资源的注册。
IPortClsStreamResourceManager2 IPortClsStreamResourceManager2 用于管理音频流资源的注册。
IPortClsVersion 微型端口驱动程序使用 IPortClsVersion 接口来标识运行驱动程序的 Windows 操作系统的版本。 端口驱动程序实现此接口并将其公开给微型端口驱动程序。
IPortEvents 微型端口驱动程序使用 IPortEvents 接口向客户端通知硬件事件。
IPortMidi IPortMidi 接口是 MIDI 端口驱动程序的主接口。
IPortTopology IPortTopology 接口为拓扑微型端口驱动程序提供通用端口驱动程序支持。
IPortWaveCyclic IPortWaveCyclic 接口是 WaveCyclic 端口驱动程序的主接口。
IPortWavePci IPortWavePci 接口是 WavePci 端口驱动程序的主接口。
IPortWavePciStream IPortWavePciStream 接口是与流关联的回调接口，它为 WavePci 微型端口流对象提供映射服务。
IPortWaveRT IPortWaveRT 接口在 Windows Vista 及更高版本的操作系统中受支持，它是 WaveRT 端口驱动程序向实现 WaveRT 微型端口驱动程序对象的适配器驱动程序公开的main接口。
IPortWaveRTStream IPortWaveRTStream 接口在 Windows Vista 及更高版本的操作系统中受支持，它是特定于流的接口，可提供 WaveRT 微型端口驱动程序使用的帮助程序方法。
IPortWMIRegistration Windows 7 及更高版本的 Windows 中提供了 IPortWMIRegistration 接口。 此接口允许微型端口驱动程序协调 Windows (ETW 的事件跟踪) PortCl 和微型端口驱动程序之间的注册。
IPowerNotify IPowerNotify 接口是一个可选接口，如果微型端口驱动程序需要提前通知即将发生的电源状态更改，则可以公开该接口。
IPreFetchOffset IPreFetchOffset 接口控制预提取偏移量，即在 DirectSound 输出流中分隔播放和写入游标的字节数。
IRegistryKey IRegistryKey 接口提供一个注册表项的抽象，微型端口驱动程序可以使用该注册表项来访问该键及其子项。
IResourceList IResourceList 接口提供配置资源列表的抽象，该列表是即插即用管理器在启动时分配给设备的系统硬件资源的列表。
IServiceGroup IServiceGroup 接口封装一组对象，这些对象都需要同一服务请求的通知。
IServiceSink IServiceSink 接口封装服务请求的处理。
IUnregisterPhysicalConnection IUnregisterPhysicalConnection 接口实现三种方法来删除已注册的物理连接。
IUnregisterSubdevice IUnregisterSubdevice 接口实现删除已注册的子设备的方法。

函数

PcAddAdapterDevice PcAddAdapterDevice 函数将适配器设备添加到 WDM 设备堆栈。
PcAddContentHandlers PcAddContentHandlers 函数为系统提供处理受保护内容的函数列表。
PcAddStreamResource PcAddStreamResource 添加流资源。
PcCompleteIrp PcCompleteIrp 函数完成之前标记为挂起的 IRP。
PcCompletePendingPropertyRequest 调用 PcCompletePendingPropertyRequest 函数来完成挂起的属性请求。
PcCreateContentMixed PcCreateContentMixed 函数计算包含来自一定数量的 KS 音频流的混合内容的复合流的 DRM 内容权限。
PcDestroyContent PcDestroyContent 函数删除由 PcCreateContentMixed 创建的 DRM 内容 ID。 请注意，此函数调用在操作中与 DrmDestroyContent 函数相同，其参数定义和返回值也相同。
PcDispatchIrp PcDispatchIrp 函数将 IRP 调度到 PortCls 系统驱动程序的默认处理程序。
PcForwardContentToDeviceObject PcForwardContentToDeviceObject 函数接受表示调用方打算将受保护内容转发到的设备的设备对象。
PcForwardContentToFileObject PcForwardContentToFileObject 函数已过时，并且仅用于支持现有驱动程序。
PcForwardContentToInterface PcForwardContentToInterface 函数接受指向调用方打算将受保护内容转发到的对象的 COM 接口的指针。
PcForwardIrpSynchronous IRP 处理程序使用 PcForwardIrpSynchronous 函数将即插即用 IRP 转发到物理设备对象 (PDO) 。
PcGetContentRights PcGetContentRights 函数检索分配给 DRM 内容 ID 的 DRM 内容权限。 请注意，此函数调用在操作上与 DrmGetContentRights 函数相同，其参数定义和返回值也相同。
PcGetDeviceProperty PcGetDeviceProperty 函数从注册表返回请求的设备属性。
PcGetPhysicalDeviceObject PcGetPhysicalDeviceObject 函数使音频微型端口驱动程序能够检索音频设备的基础物理设备对象。
PcGetTimeInterval PcGetTimeInterval 函数返回自指定时间以来经过的时间。 时间以 100 纳秒为单位。
PcInitializeAdapterDriver PcInitializeAdapterDriver 函数将适配器驱动程序绑定到 PortCls 系统驱动程序。
PcNewDmaChannel PcNewDmaChannel 函数创建新的 DMA 通道对象。 此函数已过时;有关详细信息，请参阅以下注释。
PcNewInterruptSync PcNewInterruptSync 函数创建并初始化中断同步对象。
PcNewMiniport PcNewMiniport 函数创建一个系统提供的微型端口驱动程序的实例，这些微型端口驱动程序内置于 PortCls 系统驱动程序中，portcls.sys。
PcNewPort PcNewPort 函数创建一个新的系统提供的端口驱动程序对象，其接口 (派生自基类 IPort) 由类 ID 指定。
PcNewRegistryKey PcNewRegistryKey 函数打开或创建新的注册表项，并创建一个 IRegistryKey 对象来表示该密钥。 调用方通过此对象访问密钥。
PcNewResourceList PcNewResourceList 函数创建并初始化资源列表。
PcNewResourceSublist PcNewResourceSublist 函数创建并初始化派生自另一个资源列表的空资源列表。
PcNewServiceGroup PcNewServiceGroup 函数创建并初始化服务组。
PcRegisterAdapterPnpManagement PcRegisterAdapterPnpManagement 函数将适配器的 PnP 管理接口注册到 PortCls 系统驱动程序。 它用于支持 PnP 重新平衡。
PcRegisterAdapterPowerManagement PcRegisterAdapterPowerManagement 函数将适配器的电源管理接口注册到 PortCls 系统驱动程序。
PcRegisterIoTimeout PcRegisterIoTimeout 函数为指定的设备对象注册驱动程序提供的 I/O 计时器回调例程。
PcRegisterPhysicalConnection PcRegisterPhysicalConnection 函数注册由同一适配器驱动程序实例化的两个音频适配器筛选器之间的物理连接。
PcRegisterPhysicalConnectionFromExternal PcRegisterPhysicalConnectionFromExternal 函数从外部音频适配器筛选器注册到音频适配器筛选器的物理连接。
PcRegisterPhysicalConnectionToExternal PcRegisterPhysicalConnectionToExternal 函数注册从音频适配器筛选器到外部音频适配器筛选器的物理连接。
PcRegisterSubdevice PcRegisterSubdevice 函数注册子设备，使其可供客户端使用。
PcRemoveStreamResource PcRemoveStreamResource 删除现有流资源。
PcRequestNewPowerState PcRequestNewPowerState 函数用于请求设备的新电源状态。 适配器驱动程序通常不需要此功能，但有时可用于解决某些类型的硬件问题。
PcUnregisterAdapterPnpManagement PcUnregisterAdapterPnpManagement 函数从 PortCls 类驱动程序取消注册音频适配器的 PnP 管理接口。 它用于支持 PnP 重新平衡。
PcUnregisterAdapterPowerManagement PcUnregisterAdapterPowerManagement 函数从 PortCls 类驱动程序取消注册音频适配器的电源管理接口。 PcUnregisterAdapterPowerManagement 函数在 Windows 7 及更高版本的 Windows 中可用。
PcUnregisterIoTimeout PcUnregisterIoTimeout 函数为指定设备对象注销驱动程序提供的 I/O 计时器回调例程。

回调函数

PCPFNEVENT_HANDLER EventHandler 例程处理事件请求。

结构

PCAUTOMATION_TABLE PCAUTOMATION_TABLE 结构包含微型端口驱动程序的属性、方法和事件的主表。
PCEVENT_ITEM PCEVENT_ITEM 结构用于描述特定筛选器、引脚或节点支持的事件。
PCEVENT_REQUEST PCEVENT_REQUEST 结构指定事件请求。
PCFILTER_DESCRIPTOR PCFILTER_DESCRIPTOR 结构描述了微型端口驱动程序的筛选器实现。 结构指定筛选器的引脚、节点、连接和属性。
PCMETHOD_ITEM PCMETHOD_ITEM 结构描述了筛选器、引脚或节点支持的方法。
PCMETHOD_REQUEST PCMETHOD_REQUEST 结构指定方法请求。
PCNODE_DESCRIPTOR PCNODE_DESCRIPTOR 结构描述拓扑微型端口驱动程序实现的筛选器中的节点。
PCNOTIFICATION_BUFFER IPortClsNotifications 使用的通知缓冲区。
PCPIN_DESCRIPTOR PCPIN_DESCRIPTOR结构描述引脚工厂。
PCPROPERTY_ITEM PCPROPERTY_ITEM结构描述特定筛选器、引脚或节点支持的属性。
PCPROPERTY_REQUEST PCPROPERTY_REQUEST 结构指定属性请求。
PCSTREAMRESOURCE_DESCRIPTOR PCSTREAMRESOURCE_DESCRIPTOR定义流资源。 使用 PCSTREAMRESOURCE_DESCRIPTOR_INIT 正确初始化此结构。

枚举

eChannelTargetType eChannelTargetType 枚举定义指定给定通道中 (目标) 节点类型的常量。
eEngineFormatType eEngineFormatType 枚举定义了指定音频引擎支持的音频数据类型的常量。
EPcMiniportEngineEvent 本主题介绍 EPcMiniportEngineEvent 枚举，并介绍在微型端口驱动程序报告故障错误时提供其他信息的参数。
PC_EXIT_LATENCY 本主题讨论PC_EXIT_LATENCY枚举，并介绍其成员。 延迟时间映射到设备必须能够退出其睡眠状态并进入完全正常运行状态 (D0) 的特定最大时间。
PC_REBALANCE_TYPE PC_REBALANCE_TYPE枚举描述重新均衡支持的类型。
PcStreamResourceType 本主题讨论 PcStreamResourceType 枚举，并介绍其成员。 PcStreamResourceType 枚举用于定义用于特定音频流式处理的资源类型。