EVT_WDF_RESERVE_DMA função de retorno de chamada (wdfdmatransaction.h)

  • Artigo

[Aplica-se somente ao KMDF]

A função de retorno de chamada de evento EvtReserveDma é chamada quando a estrutura tem recursos reservados para executar e liberar uma transação. Os recursos reservados incluem registros de mapa e o bloqueio do adaptador de DMA do WDM.

Sintaxe

EVT_WDF_RESERVE_DMA EvtWdfReserveDma;

void EvtWdfReserveDma(
  [in] WDFDMATRANSACTION DmaTransaction,
  [in] PVOID Context
)
{...}

Parâmetros

[in] DmaTransaction

Um identificador para o objeto de transação DMA que representa a transação à qual os recursos de DMA foram atribuídos.

[in] Context

O ponteiro de contexto especificado pelo driver em uma chamada anterior para WdfDmaTransactionAllocateResources.

Retornar valor

Nenhum

Comentários

Os drivers registram uma função de retorno de chamada de evento EvtReserveDma chamando WdfDmaTransactionAllocateResources.

A estrutura chama a função de retorno de chamada de evento EvtReserveDma de um driver quando os recursos de DMA são atribuídos para uso exclusivo com o objeto de transação associado. O driver pode inicializar e executar a transação várias vezes enquanto mantém essa reserva.

Um driver normalmente inicializa e inicia a transação de dentro de sua função de retorno de chamada de evento EvtReserveDma . Para obter mais informações sobre a sequência de reserva, consulte Reservando recursos de DMA.

O driver pode chamar WdfDmaTransactionFreeResources de dentro de EvtReserveDma.

Em sistemas operacionais anteriores a Windows 8, EvtReserveDma deve ser usado com um habilitador que especifica um habilitador de DMA no modo de pacote. Começando com Windows 8, EvtReserveDma também pode ser usado com um habilitador que especifica um habilitador de DMA no modo de sistema.

Requisitos

Requisito Valor
Plataforma de Destino Universal
Versão mínima do KMDF 1.11
Cabeçalho wdfdmatransaction.h (inclua Wdf.h)
IRQL DISPATCH_LEVEL

Confira também

WdfDmaTransactionAllocateResources

WdfDmaTransactionFreeResources