Función WdfDmaTransactionWdmGetTransferContext (wdfdmatransaction.h)

  • Artículo

[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:

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