Função WdfDmaTransactionGetDevice (wdfdmatransaction.h)
[Aplica-se somente ao KMDF]
O método WdfDmaTransactionGetDevice retorna um identificador para o objeto de dispositivo da estrutura associado a uma transação de DMA especificada.
Sintaxe
WDFDEVICE WdfDmaTransactionGetDevice(
[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
WdfDmaTransactionGetDevice retorna um identificador para o objeto de dispositivo da estrutura especificado pelo driver quando ele chamou WdfDmaTransactionCreate.
Uma verificação de bug ocorre se o driver fornece um identificador de objeto inválido.
Observações
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 dispositivo da estrutura associado a uma transação de DMA especificada.
WDFDEVICE device;
device = WdfDmaTransactionGetDevice(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) |