Funzione WdfDmaTransactionGetTransferInfo (wdfdmatransaction.h)

  • Articolo

[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)

Vedi anche

WdfDmaTransactionAllocateResources

WdfDmaTransactionExecute