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 di un canale DMA. Il provider DMA ha restituito questo handle a NetDMA nella posizione specificata nel parametro pProviderChannelContext del parametro funzione providerAllocateDmaChannel.
Valore restituito
ProviderAbortDma restituisce uno dei valori di stato seguenti:
| Codice restituito | Descrizione |
|---|---|
|
Operazione completata correttamente. |
|
L'operazione non è riuscita per motivi non specificati. |
Osservazioni
La funzione ProviderAbortDma è una funzione facoltativa per i provider NetDMA. L'interfaccia NetDMA può chiamare la funzione di ProviderAbortDma di un driver del provider DMA, se presente, per interrompere tutti i trasferimenti DMA pianificati su 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 segnalazione dello stato di completamento è abilitata, il motore DMA scrive lo stato netDmaTransferStatusHalted nell'indirizzo specificato nell'indirizzo specificato nel CompletionVirtualAddress e CompletionPhysicalAddress membri nel 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.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Supportato per i driver NetDMA 1.0 in Windows Vista. |
| piattaforma di destinazione | Finestre |
| intestazione | netdma.h (include Netdma.h) |
| IRQL | <= DISPATCH_LEVEL |