Notes
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
[S’applique uniquement à KMDF]
La méthode WdfDmaTransactionGetRequest récupère un handle dans l’objet de requête de framework associé à une transaction DMA spécifiée.
Syntaxe
WDFREQUEST WdfDmaTransactionGetRequest(
[in] WDFDMATRANSACTION DmaTransaction
);
Paramètres
[in] DmaTransaction
Handle vers un objet de transaction DMA que le pilote a obtenu à partir d’un appel précédent à WdfDmaTransactionCreate.
Valeur de retour
WdfDmaTransactionGetRequest retourne un handle à l’objet de requête de framework associé à la transaction DMA spécifiée par le paramètre DmaTransaction spécifié.
Une vérification de bogue se produit si le pilote fournit un handle d’objet non valide.
Remarques
Un pilote peut appeler WdfDmaTransactionGetRequest uniquement pour les transactions DMA créées par le pilote en appelant WdfDmaTransactionInitializeUsingRequest. Si un pilote appelle WdfDmaTransactionGetRequest pour une transaction DMA qu’il a créée en appelant WdfDmaTransactionInitialize, WdfDmaTransactionGetRequest retourne NULL.
Pour plus d’informations sur la fin des transferts DMA, consultez Fin d’unde transfert DMA.
Exemples
L’exemple de code suivant obtient un handle pour l’objet de requête de framework associé à une transaction DMA spécifiée.
WDFREQUEST request;
request = WdfDmaTransactionGetRequest(dmaTransaction);
Spécifications
| Besoin | Valeur |
|---|---|
| plateforme cible | Universel |
| version minimale de KMDF | 1.0 |
| 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), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |