Funzione WdfDmaTransactionGetDevice (wdfdmatransaction.h)
[Si applica solo a KMDF]
Il metodo WdfDmaTransactionGetDevice restituisce un handle all'oggetto dispositivo framework associato a una transazione DMA specificata.
Sintassi
WDFDEVICE WdfDmaTransactionGetDevice(
[in] WDFDMATRANSACTION DmaTransaction
);
Parametri
[in] DmaTransaction
Handle per un oggetto transazione DMA ottenuto dal driver da una chiamata precedente a WdfDmaTransactionCreate.
Valore restituito
WdfDmaTransactionGetDevice restituisce un handle all'oggetto dispositivo framework specificato dal driver quando ha chiamato WdfDmaTransactionCreate.
Se il driver fornisce un handle di oggetto non valido, si verifica un controllo di bug.
Osservazioni:
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 dispositivo framework associato a una transazione DMA specificata.
WDFDEVICE device;
device = WdfDmaTransactionGetDevice(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) |