Función WdfDmaTransactionWdmGetTransferContext (wdfdmatransaction.h)

[Solo se aplica a KMDF]

El método WdfDmaTransactionWdmGetTransferContext recupera el contexto de transferencia de WDM asociado a una transacción DMA.

Sintaxis

PVOID WdfDmaTransactionWdmGetTransferContext(
  [in] WDFDMATRANSACTION DmaTransaction
);

Parámetros

[in] DmaTransaction

Identificador de un objeto de transacción DMA inicializado desde el que se va a recuperar el contexto de transferencia.

Valor devuelto

Puntero al contexto de transferencia de DMA (PTRANSFER_CONTEXT) asociado a la transacción.

Observaciones

El contexto de transferencia DMA para una transacción se asigna cuando el controlador crea la transacción.

WdfDmaTransactionWdmGetTransferContext debe usarse con un habilitador DMA que use DMA versión 3. Para seleccionar la versión 3, establezca el miembro WdmDmaVersionOverride de WDF_DMA_ENABLER_CONFIG en 3.

El controlador puede usar el contexto de transferencia DMA para llamar directamente a las siguientes rutinas de biblioteca de WDM DMA:

• AllocateAdapterChannelEx
• CancelAdapterChannel
• CancelMappedTransfer
• GetScatterGatherListEx
• buildScatterGatherListEx

Debe inicializar la transacción DMA antes de llamar a WdfDmaTransactionWdmGetTransferContext.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 8
de la plataforma de destino de	Universal
versión mínima de KMDF	1.11
encabezado	wdfdmatransaction.h (incluya Wdf.h)
Biblioteca	Wdf01000.sys (consulte Control de versiones de la biblioteca de marcos).
irQL	<=DISPATCH_LEVEL
reglas de cumplimiento de DDI	DriverCreate(kmdf)

Consulte también

WdfDmaTransactionCreate