Função WdfDmaTransactionGetDevice (wdfdmatransaction.h)

  • Artigo

[Aplica-se somente ao KMDF]

O método WdfDmaTransactionGetDevice retorna um identificador para o objeto de dispositivo de 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.

Retornar valor

WdfDmaTransactionGetDevice retorna um identificador para o objeto de dispositivo de estrutura especificado pelo driver quando ele chamou WdfDmaTransactionCreate.

Um bug marcar ocorrerá se o driver fornecer um identificador de objeto inválido.

Comentários

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 dispositivo de estrutura associado a uma transação de DMA especificada.

WDFDEVICE device;

device = WdfDmaTransactionGetDevice(DmaTransaction);

Requisitos

Requisito Valor
Plataforma de Destino Universal
Versão mínima do KMDF 1.0
Cabeçalho wdfdmatransaction.h (inclua Wdf.h)
Biblioteca Wdf01000.sys (consulte Controle de versão da biblioteca de estrutura.)
IRQL <=DISPATCH_LEVEL
Regras de conformidade de DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Confira também

WdfDmaTransactionCreate