WdfDmaTransactionGetRequest, fonction (wdfdmatransaction.h)
[S’applique à KMDF uniquement]
La méthode WdfDmaTransactionGetRequest récupère un handle pour l’objet de demande d’infrastructure associé à une transaction DMA spécifiée.
Syntaxe
WDFREQUEST WdfDmaTransactionGetRequest(
[in] WDFDMATRANSACTION DmaTransaction
);
Paramètres
[in] DmaTransaction
Handle pour un objet de transaction DMA que le pilote a obtenu à partir d’un appel précédent à WdfDmaTransactionCreate.
Valeur retournée
WdfDmaTransactionGetRequest retourne un handle à l’objet de demande d’infrastructure associé à la transaction DMA spécifiée par le paramètre DmaTransaction .
Un bogue case activée 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 l’exécution des transferts DMA, consultez Achèvement d’un transfert DMA.
Exemples
L’exemple de code suivant obtient un handle pour l’objet de demande d’infrastructure associé à une transaction DMA spécifiée.
WDFREQUEST request;
request = WdfDmaTransactionGetRequest(dmaTransaction);
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Universal |
| Version KMDF minimale | 1.0 |
| En-tête | wdfdmatransaction.h (inclure Wdf.h) |
| Bibliothèque | Wdf01000.sys (consultez Gestion des versions de la bibliothèque d’infrastructure).) |
| IRQL | <=DISPATCH_LEVEL |
| Règles de conformité DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |