Поделиться через


Функция 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)

См. также

WdfDmaTransactionAllocateResources