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 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) |