共用方式為

PGET_DMA_ADAPTER_INFO回呼函式 （wdm.h）

  • 發行項

GetDmaAdapterInfo 例程會擷取系統 DMA 通道硬體功能的相關信息。

語法

PGET_DMA_ADAPTER_INFO PgetDmaAdapterInfo;

NTSTATUS PgetDmaAdapterInfo(
  [in]      PDMA_ADAPTER DmaAdapter,
  [in, out] PDMA_ADAPTER_INFO AdapterInfo
)
{...}

參數

[in] DmaAdapter

DMA_ADAPTER 結構的指標。 這個結構是代表驅動程式系統 DMA 通道的配接器物件。 呼叫端從先前對 ioGetDmaAdapter 例程的呼叫取得此指標。

[in, out] AdapterInfo

呼叫端配置之 DMA_ADAPTER_INFO 結構的指標。 例程會將系統 DMA 控制器的相關信息寫入這個結構。 呼叫者必須先將這個結構的 Version 成員設定為DMA_ADAPTER_INFO_VERSION1，才能呼叫 GetDmaAdapterInfo。

傳回值

如果呼叫成功，GetDmaAdapterInfo 會傳回STATUS_SUCCESS。 可能的錯誤傳回值包括下列狀態代碼。

傳回碼 描述
STATUS_NOT_SUPPORTED
 例程不支援指定版本的 DMA_ADAPTER_INFO_XXX 結構。

言論

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

GetDmaAdapterInfo 擷取下列資訊：

  • 散佈/收集清單中的元素數目上限，DMA 控制器可以在單一散佈/收集 DMA 作業中處理。
  • DMA 位址的寬度，以位為單位。
如需 DMA_ADAPTER_INFO_XXX 結構第 1 版所提供的 DMA 配接器資訊相關信息，請參閱 DMA_ADAPTER_INFO_V1。

要求

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

另請參閱

DMA_ADAPTER

DMA_ADAPTER_INFO

DMA_OPERATIONS

IoGetDmaAdapter