Función WdfDmaTransactionGetRequest (wdfdmatransaction.h)

  • Artículo

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

Consulte también

WdfDmaTransactionCreate

WdfDmaTransactionInitialize

WdfDmaTransactionInitializeUsingRequest