IPortClsStreamResourceManager::RemoveStreamResource 方法(portcls.h)
RemoveStreamResource 删除现有流资源。 RemoveStreamResource 方法只能由音频 waveRT 微型端口驱动程序使用。
语法
NTSTATUS RemoveStreamResource(
PCSTREAMRESOURCE ResourceHandle
);
参数
ResourceHandle
PCSTREAMRESOURCE – PcAddStreamResource 返回的资源句柄。 有关详细信息,请参阅 PcAddStreamResource。
返回值
此方法返回 NTSTATUS,其中包含:
- STATUS_SUCCESS – 驱动程序能够注册指定 PDO 的资源。
- STATUS_INVALID_PARAMETER – 如果驱动程序发现任何其他参数无效,则返回此错误,除了其他错误状态实例的特定情况之外。
可能会返回其他标准状态代码。
言论
为了帮助确保无故障作,音频驱动程序必须在 portcls 中注册其流式处理资源。 这样,OS 就可以管理资源,以避免音频流式处理和其他子系统之间的干扰。 流资源是音频驱动程序用于处理音频流或确保音频数据流的任何资源。
音频驱动程序必须删除以前注册的资源。 驱动程序可能会因以下系统活动而注销资源:
- 当 I/O 资源发生更改时,设备重新平衡。
- 设备电源转换(D0<- - 在资源被销毁或创建时>Dx)。 例如,在 Dx 中中断时可能会断开连接,并重新连接到 D0。
- 处理停止时,意外删除、删除即插即用事件。
- 关联的音频终结点消失时。 例如,如果创建了一个线程来处理终结点的数据流,并删除了终结点。 在这种情况下,驱动程序应删除线程流资源。
音频驱动程序必须确保在进行此调用时资源有效。
要求
要求 | 价值 |
---|---|
标头 | portcls.h |
IRQL | PASSIVE_LEVEL |