EVT_WDF_RESERVE_DMA fonction de rappel (wdfdmatransaction.h)
[S’applique à KMDF uniquement]
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 de carte 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é par le pilote dans un appel précédent à WdfDmaTransactionAllocateResources.
Valeur de retour
None
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 transaction associé. Le pilote peut initialiser et exécuter la transaction plusieurs fois tout en conservant cette réservation.
En général, un pilote initialise, puis lance la transaction à partir de sa fonction de rappel d’événement EvtReserveDma . Pour plus d’informations sur la séquence de réservations, consultez Réserver des ressources DMA.
Le pilote peut appeler WdfDmaTransactionFreeResources à partir d’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.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Universal |
| Version KMDF minimale | 1.11 |
| En-tête | wdfdmatransaction.h (inclure Wdf.h) |
| IRQL | DISPATCH_LEVEL |