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。 可能的錯誤傳回值包括下列狀態代碼。

傳回值 描述
STATUS_NOT_IMPLEMENTED
 DMA 延伸模組不會實作 FunctionNumber 所指定的函式。

備註

ConfigureAdapterChannel 不是可直接依名稱呼叫的系統例程。此例程只能由DMA_OPERATIONS結構中傳回之位址的指標呼叫 驅動程式會呼叫IoGetDmaAdapter，並將DeviceDescription參數的Version成員設定為 DEVICE_DESCRIPTION_VERSION3，以取得此例程的位址。 如果 IoGetDmaAdapter 傳回 NULL，您的平台上無法使用例程。

僅針對系統 DMA 配接 器使用 ConfigureAdapterChannel 。 請勿將此例程用於總線主機適配卡。

特定系統 DMA 控制器可能有特殊的硬體功能，設備驅動器可以透過一組或多個自定義函式來存取。 控制器可能會實作多個自定義函式，在此情況下，每個函式都是由不同的函式編號來識別。 這些函式會抽象化 DMA 硬體功能，以便在不同的硬體平台上支援相同的函式。

一般而言，自定義函式會在 DMA 控制器中設定狀態資訊，以設定硬體功能以用於後續的 DMA 傳輸。

規格需求

需求 值
最低支援的用戶端 從 Windows 8 開始提供。
目標平台 桌面
標頭 wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h)
IRQL <= DISPATCH_LEVEL

另請參閱

DMA_ADAPTER

DMA_OPERATIONS

IoGetDmaAdapter