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 (重設)
執行) 的 RunState (
StopState (已停止)

在目前的實作中， PauseState 和 StopState 代表相同的硬體狀態。

[in] NumberOfHandles

指定句柄陣列中的句柄數目。將此參數設定為非零值。

[in] Handles

DMA 引擎句柄陣列的指標。指定此參數的非 NULL 值。

傳回值

如果呼叫成功變更 DMA 引擎的狀態，SetDmaEngineState 會傳回STATUS_SUCCESS。否則，例程會傳回適當的錯誤碼。下表顯示一些可能的傳回狀態代碼。

傳回碼	Description
STATUS_INVALID_HANDLE	表示其中一個句柄無效。
STATUS_INVALID_PARAMETER	表示其中一個參數值不正確， (無效的參數值或錯誤的指標) 。
STATUS_INVALID_DEVICE_REQUEST	表示目前沒有配置任何緩衝區給其中一個 DMA 引擎。