Función WdfDmaTransactionGetTransferInfo (wdfdmatransaction.h)

  • Artículo

[Solo se aplica a KMDF]

El método WdfDmaTransactionGetTransferInfo devuelve el número de registros de mapa y entradas de lista de dispersión y recopilación necesarias para una transacción DMA inicializada.

Sintaxis

void WdfDmaTransactionGetTransferInfo(
  [in]            WDFDMATRANSACTION DmaTransaction,
  [out, optional] ULONG             *MapRegisterCount,
  [out, optional] ULONG             *ScatterGatherElementCount
);

Parámetros

[in] DmaTransaction

Identificador de un objeto de transacción DMA inicializado.

[out, optional] MapRegisterCount

Una ubicación proporcionada por el autor de la llamada que, a cambio, contiene el número de registros de mapa necesarios para la transacción especificada. Este parámetro es opcional y puede ser NULL.

[out, optional] ScatterGatherElementCount

Una ubicación proporcionada por el autor de la llamada que, a cambio, contiene el número de elementos de dispersión y recopilación necesarios para la transacción especificada. Este parámetro es opcional y puede ser NULL.

Valor devuelto

None

Observaciones

El controlador puede llamar a WdfDmaTransactionGetTransferInfo antes de llamar a WdfDmaTransactionAllocateResources o WdfDmaTransactionExecute.

Cuando se usa DMA versión 3, este método devuelve un recuento preciso del número de registros de mapa necesarios. Cuando se usan versiones anteriores de DMA, este método supone que cada página requiere un registro de mapa.

Requisitos

Requisito Value
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

WdfDmaTransactionAllocateResources

WdfDmaTransactionExecute