Функция WdfDmaTransactionGetDevice (wdfdmatransaction.h)
[Применяется только к KMDF]
Метод WdfDmaTransactionGetDevice возвращает дескриптор объекту устройства платформы, связанному с указанной транзакцией DMA.
Синтаксис
WDFDEVICE WdfDmaTransactionGetDevice(
[in] WDFDMATRANSACTION DmaTransaction
);
Параметры
[in] DmaTransaction
Дескриптор объекта транзакции DMA, полученного драйвером при предыдущем вызове WdfDmaTransactionCreate.
Возвращаемое значение
WdfDmaTransactionGetDevice возвращает дескриптор объекту устройства платформы, указанному драйвером при вызове WdfDmaTransactionCreate.
Ошибка проверка возникает, если драйвер предоставляет недопустимый дескриптор объекта.
Комментарии
Дополнительные сведения о выполнении передачи DMA см. в разделе Завершение передачи DMA.
Примеры
В следующем примере кода получается дескриптор объекта устройства платформы, связанный с указанной транзакцией DMA.
WDFDEVICE device;
device = WdfDmaTransactionGetDevice(DmaTransaction);
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Универсальное |
| Минимальная версия KMDF | 1,0 |
| Верхняя часть | wdfdmatransaction.h (включая Wdf.h) |
| Библиотека | Wdf01000.sys (см. раздел Управление версиями библиотеки платформы). |
| IRQL | <=DISPATCH_LEVEL |
| Правила соответствия DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |