Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
[Si applica solo a KMDF]
Il metodo WdfDmaTransactionGetRequest recupera un handle per l'oggetto richiesta framework associato a una transazione DMA specificata.
Sintassi
WDFREQUEST WdfDmaTransactionGetRequest(
[in] WDFDMATRANSACTION DmaTransaction
);
Parametri
[in] DmaTransaction
Handle per un oggetto transazione DMA ottenuto dal driver da una chiamata precedente a WdfDmaTransactionCreate.
Valore restituito
WdfDmaTransactionGetRequest restituisce un handle all'oggetto richiesta framework associato alla transazione DMA specificata dal parametro DmaTransaction.
Se il driver fornisce un handle di oggetto non valido, si verifica un controllo di bug.
Osservazioni:
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.
Esempi
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 minima di KMDF | 1.0 |
| intestazione | wdfdmatransaction.h (include Wdf.h) |
| Biblioteca | Wdf01000.sys (vedere Controllo delle versioni della libreria framework). |
| IRQL | <=DISPATCH_LEVEL |
| regole di conformità DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |