WdfDmaTransactionSetChannelConfigurationCallback, fonction (wdfdmatransaction.h)

[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 vers un objet de transaction DMA initialisé pour lequel définir ou effacer le rappel de configuration du canal.

[in, optional] ConfigureRoutine

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

[in, optional] ConfigureContext

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

Valeur de retour

Aucun

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énements d’E/S , un pilote effectue les étapes suivantes dans cet ordre :

1. Appelle WdfDmaTransactionInitializeUsingRequest, WdfDmaTransactionInitialize, ou WdfDmaTransactionInitializeUsingOffset pour initialiser l’objet transactionnel.
2. Appelle WdfDmaTransactionSetChannelConfigurationCallback sur l’objet transactionnel.
3. Appelle WdfDmaTransactionExecute.

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 du framework signale une erreur.

Spécifications

Voir aussi

EvtDmaTransactionConfigureDmaChannel

WdfDmaTransactionRelease