Funzione WdfDmaTransactionCancel (wdfdmatransaction.h)
[Si applica solo a KMDF]
Il metodo WdfDmaTransactionCancel tenta di annullare una transazione DMA in attesa dell'allocazione dei registri mappa.
Sintassi
BOOLEAN WdfDmaTransactionCancel(
[in] WDFDMATRANSACTION DmaTransaction
);
Parametri
[in] DmaTransaction
Handle per l'oggetto transazione DMA che rappresenta la transazione annullata. Questa transazione deve essere già stata inizializzata dal driver.
Valore restituito
WdfDmaTransactionCancel restituisce TRUE se il framework annulla correttamente l'allocazione del registro mappa. In questo caso, nessun trasferimento viene completato e il framework non effettua callback DMA aggiuntivi nella transazione finché non viene reinizializzazione.
Il metodo restituisce FALSE se un altro thread sta già elaborando questa transazione o se il driver non ha ancora chiamato WdfDmaTransactionExecute. Nel primo caso, il framework sta attualmente chiamando o chiamerà EvtProgramDma o EvtReserveDma. A questo punto, un driver che ha specificato un profilo DMA in modalità sistema potrebbe chiamare WdfDmaTransactionStopSystemTransfer.
Il metodo restituisce anche FALSE se chiamato con una transazione allocata da un abilitatore DMA versione 2.
Commenti
Il driver potrebbe chiamare WdfDmaTransactionCancel da una funzione di callback evento EvtRequestCancel fornita in una chiamata a WdfRequestMarkCancelableEx. Per un esempio di codice che illustra come eseguire questa operazione, vedere WdfDmaTransactionStopSystemTransfer.
Il driver potrebbe anche chiamare WdfDmaTransactionCancel da una funzione di callback degli eventi EvtIoCanceledOnQueue .
L'annullamento può avere esito positivo solo se la chiamata a WdfDmaTransactionCancel si verifica dopo la chiamata a WdfDmaTransactionExecute, ma prima che il metodo WdfDmaTransactionExecute abbia avviato l'allocazione DMA. Per altre informazioni, vedere Annullamento delle transazioni DMA.
Il driver deve chiamare WdfDmaTransactionCancel dopo aver chiamato WdfDmaTransactionInitialize, ma prima di chiamare WdfDmaTransactionRelease o WdfObjectDelete per eliminare l'oggetto transazione.
Non chiamare WdfDmaTransactionCancel dopo che il framework ha chiamato EvtProgramDma o EvtReserveDma.
Un driver deve richiedere l'uso di DMA versione 3 prima di chiamare WdfDmaTransactionCancel. Per selezionare DMA versione 3, impostare il membro WdmDmaVersionOverride di WDF_DMA_ENABLER_CONFIG su 3.
Se un driver chiama WdfDmaTransactionCancel in una transazione allocata da un abilitatore DMA versione 2, il framework genera un errore di verifica e WdfDmaTransactionCancel restituisce FALSE. In questo caso, non viene eseguito alcun tentativo di annullare la transazione.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 8 |
| Piattaforma di destinazione | Universale |
| Versione KMDF minima | 1.11 |
| Intestazione | wdfdmatransaction.h (include Wdf.h) |
| Libreria | Wdf01000.sys (vedere Framework Library Versioning). |
| IRQL | <=DISPATCH_LEVEL |
| Regole di conformità DDI | DriverCreate(kmdf) |