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 |