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：：NewSystemeDmaChannel
為了回溯相容性，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 函式。 |
| 目標平台 | Universal |
| 標頭 | portcls.h (包含 Portcls.h) |
| 程式庫 | Portcls.lib |
| IRQL | PASSIVE_LEVEL |