EVT_WDF_RESERVE_DMA função de retorno de chamada (wdfdmatransaction.h)
[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 |