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 – 如果驅動程序發現任何其他參數無效,除了其他錯誤狀態實例的特定案例之外,驅動程式會傳回此錯誤。
可能會傳回其他標準狀態代碼。
備註
為了協助確保無問題作業,音訊驅動程式必須向 portcl 註冊其串流資源。 這可讓OS管理資源,以避免音訊串流與其他子系統之間的干擾。
Stream 資源是音訊驅動程式用來處理音訊數據流或確保音訊數據流的任何資源。
音訊驅動程式必須移除先前註冊的資源。 驅動程式可能會因為下列系統活動而取消註冊資源:
- 當 I/O 資源變更時,裝置會重新平衡。
- 裝置電源轉換 (D0<- ->當資源損毀或建立時,Dx) 。 例如,在 Dx 中中斷時,中斷可能會中斷,並重新連線,並移至 D0。
- 處理停止、意外移除、移除隨插即用事件時。
- 當相關聯的音訊端點消失時。 例如,如果建立線程來處理端點的數據流,並移除端點。 在此情況下,驅動程式應該移除線程數據流資源。
只有在 Windows 10 中執行的音訊驅動程式可以使用PcAddStreamResource和PcRemoveStreamResource。 對於也需要在舊版 Windows 下執行的音訊 waveRT 迷你埠驅動程式,請使用 AddStreamResource 和 RemoveStreamResource。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 10 |
最低支援的伺服器 | Windows Server 2016 |
目標平台 | Windows |
標頭 | portcls.h |
程式庫 | Portcls.lib |
Dll | NA |
IRQL | PASSIVE_LEVEL |