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。
- 處理停止、意外移除、移除隨插即用事件時。
- 當相關聯的音訊端點消失時。 例如,如果建立線程來處理端點的數據流,並移除端點。 在此情況下,驅動程式應該移除線程數據流資源。
音訊驅動程式必須在進行此呼叫時,確定資源有效。
規格需求
需求 | 值 |
---|---|
標頭 | portcls.h |
IRQL | PASSIVE_LEVEL |