DMA_ABORT_HANDLER funzione di callback (netdma.h)

Nota L'interfaccia NetDMA non è supportata

in Windows 8 e versioni successive.

 

La funzione ProviderAbortDma annulla tutti i trasferimenti DMA associati a un canale DMA.

Sintassi

DMA_ABORT_HANDLER DmaAbortHandler;

NTSTATUS DmaAbortHandler(
  [in] PVOID ProviderChannelContext
)
{...}

Parametri

[in] ProviderChannelContext

Puntatore che identifica l'area di contesto del canale DMA. Il provider DMA ha restituito questo handle a NetDMA nel percorso specificato nel parametro pProviderChannelContext dell'oggetto Funzione ProviderAllocateDmaChannel .

Valore restituito

ProviderAbortDma restituisce uno dei valori di stato seguenti:

Codice restituito	Descrizione
STATUS_SUCCESS	Operazione riuscita.
STATUS_UNSUCCESSFUL	L'operazione non è riuscita per motivi non specificati.

Commenti

La funzione ProviderAbortDma è una funzione facoltativa per i provider NetDMA. L'interfaccia NetDMA può chiamare una funzione provider DMA ProviderAbortDma , se presente, per interrompere tutti i trasferimenti DMA pianificati in un canale DMA.

In ProviderAbortDma il provider DMA deve terminare immediatamente il trasferimento senza completare il trasferimento dei dati associati al descrittore DMA corrente. Se la creazione di report sullo stato di completamento è abilitata, il motore DMA scrive lo stato NetDmaTransferStatusHalted nell'indirizzo specificato nell'indirizzo completatoVirtualAddress e CompletamentoPhysicalAddress nei membri dell'oggetto NET_DMA_CHANNEL_PARAMETERS struttura.

Al termine dell'operazione di interruzione, il canale DMA deve essere pronto per l'interfaccia NetDMA per chiamare la funzione ProviderStartDma . L'interfaccia NetDMA non chiamerà la funzione ProviderAppendDma fino al riavvio del trasferimento.

NetDMA chiama ProviderAbortDma in IRQL <= DISPATCH_LEVEL.

Requisiti

Requisito	Valore
Client minimo supportato	Supportato per i driver NetDMA 1.0 in Windows Vista.
Piattaforma di destinazione	Windows
Intestazione	netdma.h (include Netdma.h)
IRQL	<= DISPATCH_LEVEL

Vedi anche

NET_DMA_CHANNEL_PARAMETERS

ProviderAllocateDmaChannel

ProviderAppendDma

ProviderStartDma