WdfDmaTransactionSetImmediateExecution, fonction (wdfdmatransaction.h)
[S’applique uniquement à KMDF]
La méthode WdfDmaTransactionSetImmediateExecution marque la transaction DMA spécifiée afin que les appels à WdfDmaTransactionExecute et WdfDmaTransactionAllocateResources lancer la transaction immédiatement ou échouer.
Syntaxe
void WdfDmaTransactionSetImmediateExecution(
[in] WDFDMATRANSACTION DmaTransaction,
[in] BOOLEAN UseImmediateExecution
);
Paramètres
[in] DmaTransaction
Handle vers un objet de transaction DMA à marquer pour l’exécution immédiate.
[in] UseImmediateExecution
Valeur booléenne qui, si TRUE, indique que la transaction doit s’exécuter immédiatement (ou échouer si les ressources ne sont pas disponibles) et, si la valeur EST FALSE, indique que la transaction doit être mise en file d’attente pour l’exécution une fois que les ressources DMA sont disponibles.
Valeur de retour
Aucun
Remarques
Avant d’appeler WdfDmaTransactionSetImmediateExecution, le pilote doit initialiser la transaction.
Si le pilote appelle WdfDmaTransactionExecute ou WdfDmaTransactionAllocateResources après avoir appelé WdfDmaTransactionSetImmediateExecution avec UseImmediateExecution défini sur TRUE, et les ressources nécessaires à la requête ne sont pas disponibles, cette méthode retourne STATUS_INSUFFICIENT_RESOURCES. Si les ressources requises sont disponibles, l’infrastructure les réclame et lance l’appel de manière synchrone.
Une fois que le pilote marque une transaction pour l’exécution immédiate, la transaction reste marquée comme telle jusqu’à ce que le pilote appelle WdfDmaTransactionRelease ou efface l’indicateur en appelant WdfDmaTransactionSetImmediateExecution avec UseImmediateExecution défini sur FALSE.
WdfDmaTransactionSetImmediateExecution nécessite DMA version 3. Pour sélectionner DMA version 3, définissez le membre WdmDmaVersionOverride de WDF_DMA_ENABLER_CONFIG sur 3.
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
| Besoin | Valeur |
|---|---|
| client minimum pris en charge | Windows 8 |
| plateforme cible | Universel |
| version minimale de KMDF | 1.11 |
| En-tête | wdfdmatransaction.h (include Wdf.h) |
| Bibliothèque | Wdf01000.sys (voir Versioning de la bibliothèque Framework.) |
| IRQL | <=DISPATCH_LEVEL |
| règles de conformité DDI | DriverCreate(kmdf) |