Función WdfDmaTransactionFreeResources (wdfdmatransaction.h)

[Solo se aplica a KMDF]

El método WdfDmaTransactionFreeResources libera los recursos DMA que el controlador asignó anteriormente mediante una llamada a WdfDmaTransactionAllocateResources.

Sintaxis

void WdfDmaTransactionFreeResources(
  [in] WDFDMATRANSACTION DmaTransaction
);

Parámetros

[in] DmaTransaction

Identificador del objeto de transacción DMA que el controlador proporcionó en una llamada anterior a WdfDmaTransactionAllocateResources.

Valor devuelto

None

Observaciones

WdfDmaTransactionFreeResources debe usarse con un habilitador DMA que especifique un paquete o perfil del sistema.

En sistemas operativos anteriores a Windows 8, WdfDmaTransactionFreeResources debe usarse con un habilitador que especifique un habilitador DMA de paquete único. A partir de Windows 8, WdfDmaTransactionFreeResources también se puede usar con un habilitador que especifica un habilitador DMA en modo sistema.

Cuando se llama con un habilitador DMA de dispersión o recopilación, WdfDmaTransactionFreeResources provoca una comprobación de errores del comprobador.

La llamada del controlador a WdfDmaTransactionFreeResources puede provocar que el marco llame a EvtProgramDma o EvtReserveDma inmediatamente.

Para obtener más información sobre DMA en modo sistema, consulte Compatibilidad con DMA System-Mode.

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