PcAddStreamResource 函式 (portcls.h)
PcAddStreamResource 會新增數據流資源。 支援兩種類型的數據流資源:中斷和驅動程式擁有的線程。 任何具有與音訊數據流相關聯的中斷/線程的非音訊 WaveRT 迷你埠驅動程式都可以呼叫PcAddStreamResource。 您也可以由音訊 WaveRT 迷你埠驅動程式呼叫。
語法
PORTCLASSAPI NTSTATUS PcAddStreamResource(
[in] PDEVICE_OBJECT PhysicalDeviceObject,
[in] PVOID ResourceSet,
[in] PPCSTREAMRESOURCE_DESCRIPTOR ResourceDescriptor,
[out] PCSTREAMRESOURCE *ResourceHandle
);
參數
[in] PhysicalDeviceObject
PDEVICE_OBJECT - 使用此資源的裝置堆疊 PDO。
[in] ResourceSet
PVOID - 保留供日後使用,設定為 NULL。 目前僅支援裝置範圍的資源。
[in] ResourceDescriptor
PPCSTREAMRESOURCE_DESCRIPTOR - 要新增的資源。 如需詳細資訊,請參閱 PCSTREAMRESOURCE_DESCRIPTOR。
[out] ResourceHandle
PCSTREAMRESOURCE* - 將保存資源句柄的位置。 如需詳細資訊,請參閱 PcRemoveStreamResource。
傳回值
STATUS_SUCCESS – 驅動程式能夠註冊指定 PDO 的資源。
STATUS_INVALID_PARAMETER – 如果驅動程序發現任何其他參數無效,除了其他錯誤狀態實例的特定案例之外,驅動程式會傳回此錯誤。
可能會傳回其他標準狀態代碼。
備註
為了協助確保無問題作業,音訊驅動程式必須使用 portcl 註冊其串流資源。 這可讓OS管理資源,以避免音訊串流與其他子系統之間的干擾。
Stream 資源是音訊驅動程式用來處理音訊數據流或確保音訊數據流的任何資源。
所有音訊驅動程式都必須向音訊類別驅動程式註冊其串流資源。 驅動程式會註冊下列資源類型:中斷、驅動程式擁有的線程與其他音訊堆疊的資源相依性, (範例:平行音訊驅動程式堆疊) 。 如需詳細資訊,請參閱 PCSTREAMRESOURCE_DESCRIPTOR 的定義。
音訊驅動程式必須在進行此呼叫時,確定資源有效。
只有在 Windows 10 中執行的音訊驅動程式可以使用PcAddStreamResource和PcRemoveStreamResource。 針對需要同時在舊版 Windows 下執行的音訊 waveRT 迷你埠驅動程式,請使用 AddStreamResource 和 RemoveStreamResource。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 10 |
最低支援的伺服器 | Windows Server 2016 |
目標平台 | Windows |
標頭 | portcls.h |
程式庫 | Portcls.lib |
Dll | NA |
IRQL | PASSIVE_LEVEL |