PcNewDmaChannel 函式 （portcls.h）
PcNewDmaChannel 函式會建立新的 DMA 通道物件。 此函式已過時;如需詳細資訊，請參閱下列批注。
語法
PORTCLASSAPI NTSTATUS PcNewDmaChannel(
[out] PDMACHANNEL *OutDmaChannel,
[in, optional] PUNKNOWN OuterUnknown,
[in] POOL_TYPE PoolType,
[in] PDEVICE_DESCRIPTION DeviceDescription,
[in] PDEVICE_OBJECT DeviceObject
);
參數
[out] OutDmaChannel
此函式所建立之 DMA 通道物件的輸出指標。 此參數指向呼叫端配置的指標變數，函式會將參考輸出至新建立 IDmaChannel 物件。 為此參數指定有效的非NULL 指標值。
[in, optional] OuterUnknown
需要匯總物件的 IUnknown 介面指標。 除非需要匯總，否則請將此參數設定為 NULL。
[in] PoolType
指定要從中配置物件的存放集區類型。 這是 POOL_TYPE 列舉值。 指定此參數的非分頁集區類型。
[in] DeviceDescription
呼叫端要求 DMA 物件之實體裝置的描述指標。 此參數指向 類型為 DEVICE_DESCRIPTION的結構。
[in] DeviceObject
實體配接器裝置之裝置物件的指標。 此參數指向 類型為 DEVICE_OBJECT的系統結構。
傳回值
如果呼叫成功，PcNewDmaChannel 會傳回STATUS_SUCCESS。 否則，它會傳回適當的錯誤碼。
言論
PcNewDmaChannel 已過時。 針對所有新的音訊驅動程式，請使用下列其中一個 IPortWave Xxx：：NewXxxDmaChannel 方法來取代 PcNewDmaChannel：
IPortWavePci：：NewMasterDmaChannel
IPortWaveCyclic：：NewMasterDmaChannel
IPortWaveCyclic：：NewSlaveDmaChannel
為了回溯相容性，PortCls 系統驅動程式將繼續支援 PcNewDmaChannel，而現有的驅動程式可以繼續使用此函式。
指定 PoolType 參數，成為POOL_TYPE列舉中定義的其中一個非分頁集區類型。 DMA 信道物件不能位於分頁記憶體中，因為可以從 IRQL DISPATCH_LEVEL呼叫 IDmaChannel 介面中的數個方法。
OutDmaChannel 和 OuterUnknown 參數遵循 COM 物件的 參考計數慣例。
注意
Microsoft支持多樣化的包容性環境。 本文包含術語的參考，Microsoft樣式指南可辨識為排除。 本文中會使用單字或片語來保持一致性，因為它目前會出現在軟體中。 當軟體更新為移除語言時，本文將會更新為對齊方式。
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | 過時。 針對所有新的音訊驅動程式，請改用 IPortWaveXxx：：NewXxxDmaChannel 方法。 PortCls 系統驅動程式會在 Microsoft Windows 98/Me 和 Windows 2000 和更新版本的作系統中實作 PcNewDmaChannel 函式。 |
| 目標平臺 | 普遍 |
| 標頭 | portcls.h （包括 Portcls.h） |
| 連結庫 | Portcls.lib |
| IRQL | PASSIVE_LEVEL |