Função WdfDmaTransactionGetRequest (wdfdmatransaction.h)
[Aplica-se somente ao KMDF]
O método WdfDmaTransactionGetRequest recupera um identificador para o objeto de solicitação de estrutura associado a uma transação DMA especificada.
Sintaxe
WDFREQUEST WdfDmaTransactionGetRequest(
[in] WDFDMATRANSACTION DmaTransaction
);
Parâmetros
[in] DmaTransaction
Um identificador para um objeto de transação DMA que o driver obteve de uma chamada anterior para WdfDmaTransactionCreate.
Valor de retorno
WdfDmaTransactionGetRequest retorna um identificador para o objeto de solicitação de estrutura associado à transação DMA especificada pelo parâmetro DmaTransaction.
Uma verificação de bug ocorre se o driver fornece um identificador de objeto inválido.
Observações
Um driver pode chamar WdfDmaTransactionGetRequest somente para transações DMA que o driver criou chamando WdfDmaTransactionInitializeUsingRequest. Se um driver chamar WdfDmaTransactionGetRequest para uma transação DMA criada chamando WdfDmaTransactionInitialize, WdfDmaTransactionGetRequest retornará NULL.
Para obter mais informações sobre como concluir transferências de DMA, consulte Concluir umde Transferência de DMA.
Exemplos
O exemplo de código a seguir obtém um identificador para o objeto de solicitação de estrutura associado a uma transação de DMA especificada.
WDFREQUEST request;
request = WdfDmaTransactionGetRequest(dmaTransaction);
Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino | Universal |
| versão mínima do KMDF | 1.0 |
| cabeçalho | wdfdmatransaction.h (inclua Wdf.h) |
| Biblioteca | Wdf01000.sys (consulte o Controle de Versão da Biblioteca da Estrutura.) |
| IRQL | <=DISPATCH_LEVEL |
| regras de conformidade de DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |