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)

Confira também

WdfDmaTransactionCreate

WdfDmaTransactionInitialize

WdfDmaTransactionInitializeUsingRequest