pcRemoveStreamResource 函数 (portcls.h)

  • 项目

PcRemoveStreamResource 删除现有流资源。 PcRemoveStreamResource 可由任何驱动程序（包括非音频 WaveRT 微型端口驱动程序）调用，这些驱动程序具有与音频流关联的中断/线程。 音频 WaveRT 微型端口驱动程序也可以调用它。

语法

PORTCLASSAPI NTSTATUS PcRemoveStreamResource(
  [in] PCSTREAMRESOURCE ResourceHandle
);

参数

[in] ResourceHandle

PCSTREAMRESOURCE - PcAddStreamResource 返回的资源句柄。
有关详细信息，请参阅 PcAddStreamResource 和 PCSTREAMRESOURCE_DESCRIPTOR。

返回值

STATUS_SUCCESS – 驱动程序能够注册指定 PDO 的资源。

STATUS_INVALID_PARAMETER – 除其他错误状态实例的特定情况外，如果驱动程序发现任何其他参数无效，则返回此错误。

可能会返回其他标准状态代码。

注解

为了帮助确保无故障运行，音频驱动程序必须使用 portcls 注册其流式资源。 这允许 OS 管理资源，以避免音频流和其他子系统之间的干扰。

Stream资源是音频驱动程序用于处理音频流或确保音频数据流的任何资源。

音频驱动程序必须删除以前注册的资源。 由于以下系统活动，驱动程序可能会注销资源：

  • 当 I/O 资源更改时，设备重新平衡。
  • 销毁或创建资源时，设备电源转换 (D0<- ->Dx) 。 例如，在 Dx 中时中断可能会断开连接，并重新连接到 D0。
  • 处理停止、意外删除、删除即插即用事件时。
  • 当关联的音频终结点消失时。 例如，如果创建了一个线程来处理终结点的数据流，并且删除了该终结点。 在这种情况下，驱动程序应删除线程流资源。
进行此调用时，音频驱动程序必须确保资源有效。

仅在 Windows 10 中运行的音频驱动程序可以使用 PcAddStreamResource 和 PcRemoveStreamResource。 对于需要在早期版本的 Windows 下运行的 Audio waveRT 微型端口驱动程序，请使用 AddStreamResource 和 RemoveStreamResource。

要求

要求 值
最低受支持的客户端 Windows 10
最低受支持的服务器 Windows Server 2016
目标平台 Windows
标头 portcls.h
Library Portcls.lib
DLL NA
IRQL PASSIVE_LEVEL

另请参阅

PCSTREAMRESOURCE_DESCRIPTOR

PcAddStreamResource

PcStreamResourceType