Funzione WdfDmaTransactionWdmGetTransferContext (wdfdmatransaction.h)

Articolo
02/27/2024

[Si applica solo a KMDF]

Il metodo WdfDmaTransactionWdmGetTransferContext recupera il contesto di trasferimento WDM associato a una transazione DMA.

Sintassi

PVOID WdfDmaTransactionWdmGetTransferContext(
  [in] WDFDMATRANSACTION DmaTransaction
);

Parametri

[in] DmaTransaction

Handle a un oggetto transazione DMA inizializzato da cui recuperare il contesto di trasferimento.

Valore restituito

Puntatore al contesto di trasferimento DMA (PTRANSFER_CONTEXT) associato alla transazione.

Commenti

Il contesto di trasferimento DMA per una transazione viene allocato quando il driver crea la transazione.

WdfDmaTransactionWdmGetTransferContext deve essere usato con un abilitatore DMA che usa DMA versione 3. Per selezionare la versione 3, impostare il membro WdmDmaVersionOverride di WDF_DMA_ENABLER_CONFIG su 3.

Il driver può usare il contesto di trasferimento DMA per chiamare direttamente le routine della libreria DMA WDM seguenti:

È necessario inizializzare la transazione DMA prima di chiamare WdfDmaTransactionWdmGetTransferContext.

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 Controllo delle versioni della libreria framework).
IRQL	<=DISPATCH_LEVEL
Regole di conformità DDI	DriverCreate(kmdf)

Vedi anche

WdfDmaTransactionCreate

Condividi tramite