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 获取的。

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

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

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

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

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