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 recuperar el contexto de transferencia.

Valor devuelto

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

Comentarios

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

WdfDmaTransactionWdmGetTransferContext debe usarse con un habilitador DMA que use la versión 3 de DMA. 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 de DMA para llamar directamente a las siguientes rutinas de biblioteca de DMA de WDM:

• AllocateAdapterChannelEx
• CancelAdapterChannel
• CancelMappedTransfer
• GetScatterGatherListEx
• BuildScatterGatherListEx

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

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 8
Plataforma de destino	Universal
Versión mínima de KMDF	1.11
Encabezado	wdfdmatransaction.h (incluya Wdf.h)
Library	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