DMA_RESUME_HANDLER callback function (netdma.h)

Article
02/22/2024

Note The NetDMA interface is not supported

in Windows 8 and later.

The ProviderResumeDma function resumes the DMA transfers that are currently suspended on a DMA channel.

Syntax

DMA_RESUME_HANDLER DmaResumeHandler;

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

Parameters

[in] ProviderChannelContext

A pointer that identifies a DMA channel's context area. The DMA provider returned this handle to NetDMA at the location that is specified in the pProviderChannelContext parameter of the ProviderAllocateDmaChannel function.

Return value

ProviderResumeDma returns one of the following status values:

Return code	Description
STATUS_SUCCESS	The operation completed successfully.
STATUS_UNSUCCESSFUL	The operation failed for unspecified reasons.

Remarks

The ProviderSuspendDma function is an optional function for NetDMA providers. The NetDMA interface calls the ProviderResumeDma function, if any, to resume DMA operations that were suspended by calling the ProviderSuspendDma function. If the DMA provider driver specifies an entry point for a ProviderSuspendDma function, it must also specify an entry point for a ProviderResumeDma function.

When the DMA engine resumes transfers, the hardware should reload the DMA descriptor that it processed last to get the new next descriptor.

NetDMA calls ProviderResumeDma at IRQL <= DISPATCH_LEVEL.

Requirements

Requirement	Value
Minimum supported client	Supported for NetDMA 1.0 drivers in Windows Vista.
Target Platform	Windows
Header	netdma.h (include Netdma.h)
IRQL	<= DISPATCH_LEVEL