Función WdfDmaTransactionSetImmediateExecution (wdfdmatransaction.h)
[Solo se aplica a KMDF]
El método WdfDmaTransactionSetImmediateExecution marca la transacción DMA especificada para que las llamadas a WdfDmaTransactionExecuteExecute y WdfDmaTransactionAllocateResources inicie la transacción inmediatamente o produzca un error.
Sintaxis
void WdfDmaTransactionSetImmediateExecution(
[in] WDFDMATRANSACTION DmaTransaction,
[in] BOOLEAN UseImmediateExecution
);
Parámetros
[in] DmaTransaction
Identificador de un objeto de transacción DMA que se va a marcar para su ejecución inmediata.
[in] UseImmediateExecution
Valor booleano que, si es TRUE, indica que la transacción debe ejecutarse inmediatamente (o producir un error si los recursos no están disponibles) y, si es FALSE, indica que la transacción se debe poner en cola para su ejecución una vez que los recursos DMA estén disponibles.
Valor devuelto
Ninguno
Observaciones
Antes de llamar a WdfDmaTransactionSetImmediateExecution, el controlador debe inicializar la transacción.
Si el controlador llama WdfDmaTransactionExecute o WdfDmaTransactionAllocateResources después de llamar a WdfDmaTransactionSetImmediateExecution con UseImmediateExecution establecido en TRUE y los recursos necesarios para la solicitud no están disponibles, ese método devuelve STATUS_INSUFFICIENT_RESOURCES. Si los recursos necesarios están disponibles, el marco los reclama e inicia la llamada de forma sincrónica.
Después de que el controlador marque una transacción para la ejecución inmediata, la transacción permanece marcada como tal hasta que el controlador llama a WdfDmaTransactionRelease o borra la marca llamando a WdfDmaTransactionSetImmediateExecution con UseImmediateExecution establecido en FALSE.
WdfDmaTransactionSetImmediateExecution requiere DMA versión 3. Para seleccionar DMA versión 3, establezca el WdmDmaVersionOverride miembro de WDF_DMA_ENABLER_CONFIG en 3.
Si el controlador llama a este método en un sistema operativo anterior a Windows 8, el comprobador del marco notifica un error.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows 8 |
| de la plataforma de destino de | Universal |
| versión mínima de KMDF | 1.11 |
| encabezado | wdfdmatransaction.h (incluya Wdf.h) |
| Biblioteca | Wdf01000.sys (consulte Control de versiones de la biblioteca de marcos). |
| irQL | <=DISPATCH_LEVEL |
| reglas de cumplimiento de DDI | DriverCreate(kmdf) |