PFREE_DMA_ENGINE回调函数（hdaudio.h）

FreeDmaEngine 例程释放以前通过调用 AllocateCaptureDmaEngine 或 AllocateRenderDmaEngine分配的 DMA 引擎。

FreeDmaEngine 例程的函数指针类型定义如下。

语法

PFREE_DMA_ENGINE PfreeDmaEngine;

NTSTATUS PfreeDmaEngine(
  [in] PVOID _context,
  [in] HANDLE Handle
)
{...}

[in] _context

[in] Handle

标识 DMA 引擎的句柄。此句柄值是从上一次调用 <AllocateCaptureDmaEngine 或 AllocateRenderDmaEngine中获取的。

如果调用成功释放 DMA 引擎，FreeDmaEngine 返回STATUS_SUCCESS。否则，例程将返回适当的错误代码。下表显示了一些可能的返回状态代码。

返回代码	描述
STATUS_INVALID_HANDLE	指示句柄参数值无效。
STATUS_INVALID_DEVICE_REQUEST	指示流未处于重置状态，或者仍为 DMA 引擎分配缓冲区。

此例程释放以前通过调用 AllocateCaptureDmaEngine 或 AllocateRenderDmaEngine 例程保留的 DMA 引擎。

此例程失败，并在以下任一情况下返回错误代码STATUS_INVALID_DEVICE_REQUEST：

音频驱动程序调用此例程以关闭引脚（并销毁流）。