Función WdfDmaTransactionGetTransferInfo (wdfdmatransaction.h)

[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 su vez, 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 su vez, 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

Ninguno

Observaciones

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

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

Requisitos

Consulte también

WdfDmaTransactionAllocateResources

WdfDmaTransactionExecute