WdfDmaTransactionGetRequest, fonction (wdfdmatransaction.h)

  • Article

[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)

Voir aussi

WdfDmaTransactionCreate

WdfDmaTransactionInitialize

WdfDmaTransactionInitializeUsingRequest