PSET_DMA_ENGINE_STATE回调函数 (hdaudio.h)

项目
02/26/2024

SetDmaEngineState 例程将一个或多个 DMA 引擎的状态设置为 Running、Stopped、Paused 或 Reset 状态。

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

语法

PSET_DMA_ENGINE_STATE PsetDmaEngineState;

NTSTATUS PsetDmaEngineState(
  [in] PVOID _context,
  [in] HDAUDIO_STREAM_STATE StreamState,
  [in] ULONG NumberOfHandles,
  [in] PHANDLE Handles
)
{...}

参数

[in] _context

指定来自 HDAUDIO_BUS_INTERFACE、HDAUDIO_BUS_INTERFACE_V2 或 HDAUDIO_BUS_INTERFACE_BDL 结构的 Context 成员的上下文值。

[in] StreamState

指定新的流状态。将此参数设置为以下HDAUDIO_STREAM_STATE枚举值之一：

PauseState (已暂停)
ResetState (reset)
运行) 的 RunState (
StopState (已停止)

在当前实现中， PauseState 和 StopState 表示相同的硬件状态。

[in] NumberOfHandles

指定句柄数组中的句柄数。将此参数设置为非零值。

[in] Handles

指向 DMA 引擎句柄数组的指针。为此参数指定非 NULL 值。

返回值

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

返回代码	说明
STATUS_INVALID_HANDLE	指示其中一个句柄无效。
STATUS_INVALID_PARAMETER	指示其中一个参数值不正确 (无效参数值或指针) 错误。
STATUS_INVALID_DEVICE_REQUEST	指示当前没有为其中一个 DMA 引擎分配缓冲区。