Función WdfDmaTransactionGetRequest (wdfdmatransaction.h)
[Solo se aplica a KMDF]
El método WdfDmaTransactionGetRequest recupera un identificador para el objeto de solicitud de marco asociado a una transacción DMA especificada.
Sintaxis
WDFREQUEST WdfDmaTransactionGetRequest(
[in] WDFDMATRANSACTION DmaTransaction
);
Parámetros
[in] DmaTransaction
Identificador de un objeto de transacción DMA que el controlador obtuvo de una llamada anterior a WdfDmaTransactionCreate.
Valor devuelto
WdfDmaTransactionGetRequest devuelve un identificador al objeto de solicitud de marco asociado a la transacción DMA que especificó el parámetro DmaTransaction .
Se produce una comprobación de errores si el controlador proporciona un identificador de objeto no válido.
Comentarios
Un controlador puede llamar a WdfDmaTransactionGetRequest solo para las transacciones DMA creadas por el controlador llamando a WdfDmaTransactionInitializeUsingRequest. Si un controlador llama a WdfDmaTransactionGetRequest para una transacción DMA que creó llamando a WdfDmaTransactionInitialize, WdfDmaTransactionGetRequest devuelve NULL.
Para obtener más información sobre cómo completar las transferencias de DMA, consulte Finalización de una transferencia de DMA.
Ejemplos
En el ejemplo de código siguiente se obtiene un identificador para el objeto de solicitud de marco asociado a una transacción DMA especificada.
WDFREQUEST request;
request = WdfDmaTransactionGetRequest(dmaTransaction);
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Universal |
| Versión mínima de KMDF | 1.0 |
| 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), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |