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

См. также раздел

WdfDmaTransactionAllocateResources