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 de 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.
Retornar valor
WdfDmaTransactionGetRequest retorna um identificador para o objeto de solicitação de estrutura associado à transação DMA especificada pelo parâmetro DmaTransaction .
Um bug marcar ocorrerá se o driver fornecer um identificador de objeto inválido.
Comentários
Um driver pode chamar WdfDmaTransactionGetRequest somente para transações de DMA que o driver criou chamando WdfDmaTransactionInitializeUsingRequest. Se um driver chamar WdfDmaTransactionGetRequest para uma transação de DMA criada chamando WdfDmaTransactionInitialize, WdfDmaTransactionGetRequest retornará NULL.
Para obter mais informações sobre como concluir transferências de DMA, consulte Concluindo uma 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 |
|---|---|
| Plataforma de Destino | Universal |
| Versão mínima do KMDF | 1.0 |
| Cabeçalho | wdfdmatransaction.h (include Wdf.h) |
| Biblioteca | Wdf01000.sys (consulte Controle de versão da biblioteca de estrutura.) |
| IRQL | <=DISPATCH_LEVEL |
| Regras de conformidade da DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |