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 微型端口驱动程序对象的适配器驱动程序公开的主接口。
IPortWaveRTStream IPortWaveRTStream 接口在 Windows Vista 和更高版本的作系统中受支持，它是一个特定于流的接口，它提供帮助程序方法供 WaveRT 微型端口驱动程序使用。
IPortWMIRegistration IPortWMIRegistration 接口在 Windows 7 及更高版本的 Windows 中提供。此接口允许微型端口驱动程序协调 PortCls 和微型端口驱动程序之间的 Windows 事件跟踪（ETW）注册。
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 函数向 PortCls 系统驱动程序注册适配器的 PnP 管理接口。它用于支持 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 枚举用于定义用于特定音频流式处理的资源类型。

反馈

此页面是否有帮助？

Last updated on 2023-08-07

通过

portcls.h 标头

接口

功能

回调函数

结构

枚举

反馈

其他资源