PCANCEL_MAPPED_TRANSFER回调函数 (wdm.h)

项目
02/27/2024

CancelMappedTransfer 例程取消当前映射到适配器的系统 DMA 传输。

语法

PCANCEL_MAPPED_TRANSFER PcancelMappedTransfer;

NTSTATUS PcancelMappedTransfer(
  [in] PDMA_ADAPTER DmaAdapter,
  [in] PVOID DmaTransferContext
)
{...}

参数

[in] DmaAdapter

指向 DMA_ADAPTER 结构的指针。此结构是等待挂起的 DMA 传输完成的适配器对象。调用方从对 IoGetDmaAdapter 例程的上一次调用中获取了此指针，调用方将此指针传递给为 DMA 传输设置映射寄存器的 MapTransferEx 调用。

[in] DmaTransferContext

指向 DMA 传输上下文的指针。此参数值必须是传递给请求适配器通道分配的 AllocateAdapterChannelEx 调用的同一 DMA 传输上下文。

返回值

如果调用成功，CancelMappedTransfer 将返回STATUS_SUCCESS。否则，它将返回相应的错误代码。

注解

CancelMappedTransfer 不是可直接按名称调用的系统例程。此例程只能由DMA_OPERATIONS结构中返回的地址中的指针调用 。驱动程序通过调用 IoGetDmaAdapter（DeviceDescription 参数的 Version 成员设置为 DEVICE_DESCRIPTION_VERSION3）来获取此例程的地址。如果 IoGetDmaAdapter 返回 NULL，则例程在平台上不可用。

此例程将关联的传输上下文标记为已取消，从而阻止在此上下文下进行任何进一步的传输。取消传输后，会调用其完成例程，但传输状态可能设置为 DmaCancelled。

无论系统 DMA 传输是取消还是完成，都必须始终调用 FlushAdapterBuffers 或 FlushAdapterBuffersEx 例程，以刷新在 DMA 传输操作结束时保留在系统 DMA 控制器内部缓存中的任何数据。取消或完成传输后， 必须先进行 FlushAdapterBuffersXxx 调用，然后才能释放 DMA 通道或调用 MapTransferEx 例程，以便为新的 DMA 传输设置映射寄存器。

要求

要求	值
最低受支持的客户端	从Windows 8开始可用。
目标平台	桌面
标头	wdm.h（包括 Wdm.h、Ntddk.h、Ntifs.h）
IRQL	<= DISPATCH_LEVEL