NetDmaProviderStart function (netdma.h)
in Windows 8 and later.
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 |