通过

IPortClsStreamResourceManager：：RemoveStreamResource 方法 (portcls.h)

  • 项目

RemoveStreamResource 删除现有流资源。 RemoveStreamResource 方法只能由音频 waveRT 微型端口驱动程序使用。

语法

NTSTATUS RemoveStreamResource(
  PCSTREAMRESOURCE ResourceHandle
);

参数

ResourceHandle

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

返回值

此方法返回 NTSTATUS，其中包含：

  • STATUS_SUCCESS – 驱动程序能够注册指定 PDO 的资源。
  • STATUS_INVALID_PARAMETER – 除其他错误状态实例的特定情况外，如果驱动程序发现任何其他参数无效，则驱动程序将返回此错误。

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

注解

为了帮助确保无故障操作，音频驱动程序必须使用 portcl 注册其流式处理资源。 这样，OS 就可以管理资源，以避免音频流式处理和其他子系统之间的干扰。 Stream资源是音频驱动程序用于处理音频流或确保音频数据流的任何资源。

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

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

进行此调用时，音频驱动程序必须确保资源有效。

要求

要求 值
Header portcls.h
IRQL PASSIVE_LEVEL

另请参阅

IPortClsStreamResourceManager