EVT_WDF_RESERVE_DMA fonction de rappel (wdfdmatransaction.h)
[S’applique uniquement à KMDF]
La fonction de rappel d’événement EvtReserveDma est appelée lorsque l’infrastructure dispose de ressources réservées pour exécuter et libérer une transaction. Les ressources réservées incluent les registres cartographiques et le verrou de l’adaptateur DMA WDM.
Syntaxe
EVT_WDF_RESERVE_DMA EvtWdfReserveDma;
void EvtWdfReserveDma(
[in] WDFDMATRANSACTION DmaTransaction,
[in] PVOID Context
)
{...}
Paramètres
[in] DmaTransaction
Handle de l’objet de transaction DMA qui représente la transaction à laquelle les ressources DMA ont été affectées.
[in] Context
Pointeur de contexte spécifié dans un appel précédent à WdfDmaTransactionAllocateResources.
Valeur de retour
Aucun
Remarques
Les pilotes inscrivent une fonction de rappel d’événement EvtReserveDma en appelant WdfDmaTransactionAllocateResources.
L’infrastructure appelle la fonction de rappel d’événement evtReserveDma d’un pilote lorsque des ressources DMA ont été affectées pour une utilisation exclusive avec l’objet transactionnel associé. Le pilote peut initialiser et exécuter la transaction plusieurs fois lors de la conservation de cette réservation.
Un pilote initialise généralement et lance la transaction à partir de son EvtReserveDma fonction de rappel d’événement. Pour plus d’informations sur la séquence de réservations, consultez réserver des ressources DMA.
Le pilote peut appeler WdfDmaTransactionFreeResources à partir de EvtReserveDma.
Sur les systèmes d’exploitation antérieurs à Windows 8, EvtReserveDma doit être utilisé avec un enabler qui spécifie un enabler DMA en mode paquet. À compter de Windows 8, EvtReserveDma peut également être utilisé avec un enabler qui spécifie un enabler DMA en mode système.
Spécifications
| Besoin | Valeur |
|---|---|
| plateforme cible | Universel |
| version minimale de KMDF | 1.11 |
| En-tête | wdfdmatransaction.h (include Wdf.h) |
| IRQL | DISPATCH_LEVEL |