Funzione WdfDmaTransactionWdmGetTransferContext (wdfdmatransaction.h)

  • Articolo

[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