WdfDmaTransactionSetChannelConfigurationCallback, fonction (wdfdmatransaction.h)

Article
02/27/2024

[S’applique uniquement à KMDF]

La méthode WdfDmaTransactionSetChannelConfigurationCallback inscrit une fonction de rappel d’événement de configuration de canal pour une transaction DMA en mode système.

Syntaxe

void WdfDmaTransactionSetChannelConfigurationCallback(
  [in]           WDFDMATRANSACTION                             DmaTransaction,
  [in, optional] PFN_WDF_DMA_TRANSACTION_CONFIGURE_DMA_CHANNEL ConfigureRoutine,
  [in, optional] PVOID                                         ConfigureContext
);

Paramètres

[in] DmaTransaction

Handle d’un objet de transaction DMA initialisé pour lequel définir ou effacer le rappel de configuration de canal.

[in, optional] ConfigureRoutine

Pointeur vers la fonction de rappel d’événement EvtDmaTransactionConfigureDmaChannel du pilote ou NULL pour l’effacer.

[in, optional] ConfigureContext

Pointeur vers une mémoire tampon contenant le contexte à fournir à la fonction de rappel d’événement EvtDmaTransactionConfigureDmaChannel du pilote, ou NULL.

Valeur de retour

None

Remarques

Cette méthode permet au pilote de personnaliser la configuration de l’adaptateur avant de programmer le contrôleur DMA système.

En règle générale, à partir d’une fonction de rappel d’événement de file d’attente d’E/S, un pilote effectue les étapes suivantes, dans cet ordre :

Appelle WdfDmaTransactionInitializeUsingRequest, WdfDmaTransactionInitialize ou WdfDmaTransactionInitializeUsingOffset pour initialiser l’objet transaction.
Appelle WdfDmaTransactionSetChannelConfigurationCallback sur l’objet de transaction.
Appelle WdfDmaTransactionExecute.

Si le pilote a spécifié une fonction de rappel d’événement EvtDmaTransactionConfigureDmaChannel en appelant WdfDmaTransactionSetChannelConfigurationCallback et que le pilote appelle ensuite WdfDmaTransactionRelease, le rappel est effacé.

WdfDmaTransactionSetChannelConfigurationCallback doit être utilisé avec un enabler DMA qui spécifie un profil DMA en mode système.

Si votre pilote appelle cette méthode sur un système d’exploitation antérieur à Windows 8, le vérificateur de l’infrastructure signale une erreur.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 8
Plateforme cible	Universal
Version KMDF minimale	1.11
En-tête	wdfdmatransaction.h (inclure Wdf.h)
Bibliothèque	Wdf01000.sys (consultez Gestion de version de la bibliothèque d’infrastructure.)
IRQL	<=DISPATCH_LEVEL
Règles de conformité DDI	DriverCreate(kmdf)

Voir aussi

EvtDmaTransactionConfigureDmaChannel

WdfDmaTransactionRelease

Partager via