Funzione WdfDmaTransactionGetRequest (wdfdmatransaction.h)
[Si applica solo a KMDF]
Il metodo WdfDmaTransactionGetRequest recupera un handle all'oggetto richiesta del framework associato a una transazione DMA specificata.
Sintassi
WDFREQUEST WdfDmaTransactionGetRequest(
[in] WDFDMATRANSACTION DmaTransaction
);
Parametri
[in] DmaTransaction
Handle a un oggetto transazione DMA ottenuto dal driver da una chiamata precedente a WdfDmaTransactionCreate.
Valore restituito
WdfDmaTransactionGetRequest restituisce un handle all'oggetto richiesta del framework associato alla transazione DMA specificata dal parametro DmaTransaction .
Un controllo di bug si verifica se il driver fornisce un handle di oggetti non valido.
Commenti
Un driver può chiamare WdfDmaTransactionGetRequest solo per le transazioni DMA create dal driver chiamando WdfDmaTransactionInitializeUsingRequest. Se un driver chiama WdfDmaTransactionGetRequest per una transazione DMA creata chiamando WdfDmaTransactionInitialize, WdfDmaTransactionGetRequest restituisce NULL.
Per altre informazioni sul completamento dei trasferimenti DMA, vedere Completamento di un trasferimento DMA.
Esempio
Nell'esempio di codice seguente viene ottenuto un handle per l'oggetto richiesta framework associato a una transazione DMA specificata.
WDFREQUEST request;
request = WdfDmaTransactionGetRequest(dmaTransaction);
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Universale |
| Versione KMDF minima | 1.0 |
| Intestazione | wdfdmatransaction.h (include Wdf.h) |
| Libreria | Wdf01000.sys (vedere Framework Library Versioning). |
| IRQL | <=DISPATCH_LEVEL |
| Regole di conformità DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |