função de retorno de chamada DMA_SUSPEND_HANDLER (netdma.h)
em Windows 8 e posteriores.
Sintaxe
DMA_SUSPEND_HANDLER DmaSuspendHandler;
NTSTATUS DmaSuspendHandler(
[in] PVOID ProviderChannelContext,
[out] PPHYSICAL_ADDRESS *pLastDescriptor
)
{...}
Parâmetros
[in] ProviderChannelContext
Um ponteiro que identifica a área de contexto de um canal DMA. O provedor de DMA retornou esse identificador ao NetDMA no local especificado no parâmetro pProviderChannelContext do Função ProviderAllocateDmaChannel .
[out] pLastDescriptor
Um ponteiro para uma variável que contém o endereço físico do último descritor de DMA processado com êxito. O provedor de DMA fornece esse endereço antes de retornar de ProviderSuspendDma.
Retornar valor
ProviderSuspendDma retorna um dos seguintes valores de status:
| Código de retorno | Descrição |
|---|---|
|
A operação foi concluída com sucesso. |
|
A operação falhou por motivos não especificados. |
Comentários
A função ProviderSuspendDma é uma função opcional para provedores NetDMA. A interface NetDMA pode chamar a função ProviderSuspendDma , se houver, para suspender temporariamente quaisquer transferências de DMA em andamento em um canal DMA.
O provedor de DMA conclui a transferência do descritor DMA atual antes de retornar de ProviderSuspendDma. Se a conclusão status relatório estiver habilitada, o mecanismo de DMA gravará o status NetDmaTransferStatusSuspend no endereço especificado nos membros CompletionVirtualAddress e CompletionPhysicalAddress no NET_DMA_CHANNEL_PARAMETERS estrutura.
Enquanto as transferências de DMA são suspensas, a interface NetDMA pode modificar a lista vinculada do descritor de DMA (por exemplo, para inserir ou excluir descritores).
A interface NetDMA chama a função ProviderResumeDma para retomar as operações de DMA que foram suspensas chamando ProviderSuspendDma.
O NetDMA chama ProviderSuspendDma em IRQL <= DISPATCH_LEVEL.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Com suporte para drivers NetDMA 1.0 no Windows Vista. |
| Plataforma de Destino | Windows |
| Cabeçalho | netdma.h (inclua Netdma.h) |
| IRQL | <= DISPATCH_LEVEL |