PcRemoveStreamResource 函数 (portcls.h)

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

语法

PORTCLASSAPI NTSTATUS PcRemoveStreamResource(
  [in] PCSTREAMRESOURCE ResourceHandle
);

参数

[in] ResourceHandle

PCSTREAMRESOURCE – PcAddStreamResource 返回的资源句柄。
有关详细信息,请参阅 PcAddStreamResourcePCSTREAMRESOURCE_DESCRIPTOR

返回值

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

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

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

言论

为了帮助确保无故障作,音频驱动程序必须在 portcls 中注册其流式处理资源。 这样,OS 就可以管理资源,以避免音频流式处理和其他子系统之间的干扰。

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

音频驱动程序必须删除以前注册的资源。 驱动程序可能会因以下系统活动而注销资源:

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

仅在 Windows 10 中运行的音频驱动程序可以使用 PcAddStreamResourcePcRemoveStreamResource。 对于还需要在早期版本的 Windows 下运行的音频 waveRT 微型端口驱动程序,请使用 AddStreamResourceRemoveStreamResource

要求

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

另请参阅

PCSTREAMRESOURCE_DESCRIPTOR

PcAddStreamResource

PcStreamResourceType