Edit

Share via

DMA_RESUME_HANDLER callback function (netdma.h)

  • Article
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

See also

ProviderAllocateDmaChannel

ProviderSuspendDma