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

Voir aussi

WdfDmaTransactionAllocateResources

WdfDmaTransactionFreeResources