função de retorno de chamada DMA_SUSPEND_HANDLER (netdma.h)

Nota Não há suporte para a interface NetDMA

em Windows 8 e posteriores.

 

A função ProviderSuspendDma suspende as transferências de DMA que estão em andamento em um canal DMA.

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
STATUS_SUCCESS	A operação foi concluída com sucesso.
STATUS_UNSUCCESSFUL	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

Confira também

NET_DMA_CHANNEL_PARAMETERS

ProviderAllocateDmaChannel

ProviderResumeDma