DMA_ABORT_HANDLER funzione di callback (netdma.h)
in Windows 8 e versioni successive.
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 |
|---|---|
|
Operazione riuscita. |
|
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 |