NetDmaProviderStart function (netdma.h)

Article
10/21/2021

Note The NetDMA interface is not supported

in Windows 8 and later.

The NetDmaProviderStart function notifies the NetDMA interface that all of the DMA channels that are associated with a DMA provider are initialized and ready for DMA transfers.

Syntax

NET_DMA_EXPORT VOID NetDmaProviderStart(
  [in] PVOID                        NetDmaProviderHandle,
  [in] PNET_DMA_PROVIDER_ATTRIBUTES ProviderAttributes
);

Parameters

[in] NetDmaProviderHandle

A handle that identifies a DMA provider. The DMA provider driver received this handle from the NetDMA interface in a call to the NetDmaRegisterProvider function.

[in] ProviderAttributes

A pointer to a NET_DMA_PROVIDER_ATTRIBUTES structure that defines the DMA device attributes of the DMA provider.

Return value

None

Remarks

DMA providers call the NetDmaProviderStart function to notify the NetDMA interface that a DMA provider is started. A DMA provider driver initializes a DMA engine and calls the NetDmaProviderStart function while handling the IRP_MN_START_DEVICE IRP.

The DMA provider driver can also call NetDmaProviderStart after the driver called the NetDmaProviderStop function for application-specific reasons. DMA provider drivers call NetDmaProviderStop to notify the NetDMA interface that a previously started DMA provider is no longer available.

The DMA provider driver supplies a NET_DMA_PROVIDER_ATTRIBUTES structure at the ProviderAttributes parameter of NetDmaProviderStart. The NET_DMA_PROVIDER_ATTRIBUTES structure specifies the configuration attributes for a NetDMA provider.

Before a DMA provider driver calls NetDmaProviderStart, it should be ready to handle all NetDMA interface requests, such as allocating DMA channels and performing DMA transfers.

Requirements

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