共用方式為

DMA_ABORT_HANDLER回呼函式 （netdma.h）

  • 發行項
附注 不支援 NetDMA 介面

在 Windows 8 和更新版本中。

 
ProviderAbortDma 函式會取消與 DMA 通道相關聯的任何 DMA 傳輸。

語法

DMA_ABORT_HANDLER DmaAbortHandler;

NTSTATUS DmaAbortHandler(
  [in] PVOID ProviderChannelContext
)
{...}

參數

[in] ProviderChannelContext

識別 DMA 通道內容區域的指標。 DMA 提供者在 pProviderChannelContext 參數中指定的位置，將此句柄傳回給 NetDMA ProviderAllocateDmaChannel 函式。

傳回值

ProviderAbortDma 會傳回下列其中一個狀態值：

傳回碼 描述
STATUS_SUCCESS
 作業已順利完成。
STATUS_UNSUCCESSFUL
 作業因未指定的原因而失敗。

言論

ProviderAbortDma 函式是 NetDMA 提供者的選擇性函式。 NetDMA 介面可以呼叫 DMA 提供者驅動程式的 ProviderAbortDma 函式，如果有的話，中止已排程在 DMA 通道上的所有 DMA 傳輸。

在 ProviderAbortDma中，DMA 提供者應該立即終止傳輸，而不需要完成與目前 DMA 描述元相關聯的數據傳輸。 如果啟用完成狀態報告，DMA 引擎會在 CompletionVirtualAddress 和 CompletionPhysicalAddress 成員中指定的位址中寫入 NetDmaTransferStatusHalted 狀態 狀態 NET_DMA_CHANNEL_PARAMETERS 結構。

中止作業完成之後，DMA 通道必須準備好讓 NetDMA 介面呼叫 ProviderStartDma 函式。 NetDMA 介面在傳輸重新啟動之前，不會呼叫 ProviderAppendDma 函式。

NetDMA 會在 IRQL <= DISPATCH_LEVEL 呼叫 ProviderAbortDma。

要求

要求 價值
最低支援的用戶端 支援 Windows Vista 中的 NetDMA 1.0 驅動程式。
目標平臺 窗戶
標頭 netdma.h （包括 Netdma.h）
IRQL <= DISPATCH_LEVEL

另請參閱

NET_DMA_CHANNEL_PARAMETERS

ProviderAllocateDmaChannel

ProviderAppendDma

ProviderStartDma