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 a 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 precedenti di DMA, questo metodo presuppone che ogni pagina richieda un registro mappa.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Universale
versione minima di KMDF	1.11
intestazione	wdfdmatransaction.h (include Wdf.h)
Biblioteca	Wdf01000.sys (vedere Controllo delle versioni della libreria framework).
IRQL	<=DISPATCH_LEVEL
regole di conformità DDI	DriverCreate(kmdf)

Vedere anche

WdfDmaTransactionAllocateResources

WdfDmaTransactionExecute