Функция WdfDmaTransactionFreeResources (wdfdmatransaction.h)
[Относится только к KMDF]
Метод WdfDmaTransactionFreeResources освобождает ресурсы DMA, которые драйвер ранее выделил, вызвав WdfDmaTransactionAllocateResources.
Синтаксис
void WdfDmaTransactionFreeResources(
[in] WDFDMATRANSACTION DmaTransaction
);
Параметры
[in] DmaTransaction
Дескриптор объекта транзакции DMA, предоставленного драйвером в предыдущем вызове WdfDmaTransactionAllocateResources.
Возвращаемое значение
None
Remarks
WdfDmaTransactionFreeResources необходимо использовать с активатором DMA, который указывает пакет или системный профиль.
В операционных системах, предшествующих Windows 8, WdfDmaTransactionFreeResources необходимо использовать с включателем, указывающим однопакетный активатор DMA. Начиная с Windows 8, WdfDmaTransactionFreeResources также можно использовать с включателем, который указывает системный режим включения DMA.
При вызове с помощью средства включения точечной и сборной DMA WdfDmaTransactionFreeResources вызывает ошибку средства проверки проверка.
Вызов драйвера к WdfDmaTransactionFreeResources может привести к немедленному вызову платформы EvtProgramDma или EvtReserveDma .
Дополнительные сведения о системном режиме DMA см. в разделе Поддержка System-Mode DMA.
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Универсальное |
| Минимальная версия KMDF | 1.11 |
| Верхняя часть | wdfdmatransaction.h (включая Wdf.h) |
| Библиотека | Wdf01000.sys (см. раздел Управление версиями библиотеки Платформы). |
| IRQL | <=DISPATCH_LEVEL |
| Правила соответствия DDI | DriverCreate(kmdf) |