DMA_RESET_HANDLER回呼函式 （netdma.h）

語法

DMA_RESET_HANDLER DmaResetHandler;

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

參數

[in] ProviderChannelContext

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

傳回值

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

言論

ProviderResetChannel 函式是 NetDMA 提供者的選擇性函式。 NetDMA 介面會呼叫 DMA 提供者驅動程式的 ProviderResetChannel 函式，如果有的話，重設 DMA 通道。

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

重設作業完成之後，DMA 通道必須處於配置通道之後存在的初始狀態。 在 NetDMA 介面呼叫 ProviderResetChannel之後，DMA 提供者無法存取任何先前提交的 DMA 描述元。 DMA 信道必須準備好讓 NetDMA 介面呼叫 ProviderStartDma 函式。

NetDMA 會在 IRQL = DISPATCH_LEVEL 呼叫 <。

要求

另請參閱

NET_DMA_CHANNEL_PARAMETERS

ProviderAllocateDmaChannel

ProviderStartDma