PCONFIGURE_ADAPTER_CHANNEL回呼函式 （wdm.h）
ConfigureAdapterChannel 例程會叫用由配接器物件所表示之 DMA 控制器所實作的自定義函式。
語法
PCONFIGURE_ADAPTER_CHANNEL PconfigureAdapterChannel;
NTSTATUS PconfigureAdapterChannel(
[in] PDMA_ADAPTER DmaAdapter,
[in] ULONG FunctionNumber,
[in] PVOID Context
)
{...}
參數
[in] DmaAdapter
DMA_ADAPTER 結構的指標。 這個結構是代表驅動程式系統 DMA 通道的配接器物件。 呼叫端從先前對 ioGetDmaAdapter 例程的呼叫取得此指標。
[in] FunctionNumber
要選取的自定義函式數目。 如需詳細資訊，請參閱一節。
[in] Context
FunctionNumber 所指定之自定義函式之組態參數的指標，。 函式是由 DMA 控制器實作，而且可由設備驅動器透過配接器物件存取。 DMA 控制器和裝置驅動程式必須同意這些組態參數的意義。 Context 所指向的數據不透明於作系統。
傳回值
如果呼叫成功，ConfigureAdapterChannel 會傳回STATUS_SUCCESS。 可能的錯誤傳回值包括下列狀態代碼。
| 傳回值 | 描述 |
|---|---|
|
DMA 延伸模組不會實作 functionNumber所指定的函式。 |
言論
ConfigureAdapterChannel 不是可以直接依名稱呼叫的系統例程。這個例程只能由 DMA_OPERATIONS 結構中傳回之位址的指標呼叫。驅動程式會呼叫 ioGetDmaAdapter ，並將 DeviceDescription 參數的 Version 成員 DEVICE_DESCRIPTION_VERSION3呼叫 IoGetDmaAdapter，以取得此例程的位址。 如果 IoGetDmaAdapter 傳回 NULL ，則您的平台上無法使用例程。
請只針對系統 DMA 配接器使用 ConfigureAdapterChannel。 請勿將此例程用於總線主要適配卡。
特定系統 DMA 控制器可能有特殊的硬體功能，設備驅動器可以透過一或多個自定義功能來存取。 控制器可能會實作多個自定義函式，在此情況下，每個函式都是由不同的函式編號來識別。 這些函式會抽象化 DMA 硬體功能，以便在不同的硬體平台上支援相同的功能。
一般而言，自定義函式會在 DMA 控制器中設定狀態資訊，以設定硬體功能以用於後續的 DMA 傳輸。
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | 從 Windows 8 開始提供。 |
| 目標平臺 | 桌面 |
| 標頭 | wdm.h （包括 Wdm.h、Ntddk.h、Ntifs.h） |
| IRQL | <= DISPATCH_LEVEL |