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