Funzione WdfDmaTransactionGetTransferInfo (wdfdmatransaction.h)
[Si applica solo a KMDF]
Il metodo WdfDmaTransactionGetTransferInfo restituisce il numero di registri mappa e voci di elenco a dispersione/raccolta necessarie per una transazione DMA inizializzata.
Sintassi
void WdfDmaTransactionGetTransferInfo(
[in] WDFDMATRANSACTION DmaTransaction,
[out, optional] ULONG *MapRegisterCount,
[out, optional] ULONG *ScatterGatherElementCount
);
Parametri
[in] DmaTransaction
Handle per un oggetto transazione DMA inizializzato.
[out, optional] MapRegisterCount
Posizione fornita dal chiamante che, in caso di restituzione, contiene il numero di registri mappa necessari per la transazione specificata. Questo parametro è facoltativo e può essere NULL.
[out, optional] ScatterGatherElementCount
Posizione fornita dal chiamante che, in caso di restituzione, contiene il numero di elementi di dispersione/raccolta necessari per la transazione specificata. Questo parametro è facoltativo e può essere NULL.
Valore restituito
nessuno
Osservazioni
Il driver potrebbe chiamare WdfDmaTransactionGetTransferInfo prima di chiamare WdfDmaTransactionAllocateResources o WdfDmaTransactionExecute.
Quando si usa DMA versione 3, questo metodo restituisce un conteggio accurato del numero di registri mappa necessari. Quando si usano versioni DMA precedenti, questo metodo presuppone che ogni pagina richieda un registro mappa.
Requisiti
| Requisito | Valore |
|---|---|
| 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) |