Share via

(hdaudio.h) PGET_LINK_POSITION_REGISTER 回呼函式

  • 發行項

例 GetLinkPositionRegister 程會擷取 DMA 引擎連結位置緩存器的指標。

例程的 GetLinkPositionRegister 函式指標類型定義如下。

語法

PGET_LINK_POSITION_REGISTER PgetLinkPositionRegister;

NTSTATUS PgetLinkPositionRegister(
  [in]  PVOID _context,
  [in]  HANDLE Handle,
  [out] PULONG *Position
)
{...}

參數

[in] _context

指定來自HDAUDIO_BUS_INTERFACE、HDAUDIO_BUS_INTERFACE_V2或HDAUDIO_BUS_INTERFACE_BDL結構之Context成員的內容值。

[in] Handle

識別 DMA 引擎的句柄。 這個句柄值是從先前呼叫 AllocateCaptureDmaEngine 或 AllocateRenderDmaEngine 取得。

[out] Position

擷取連結位置緩存器指標。 此參數指向呼叫端配置的PULONG變數，而例程會將指標寫入緩存器。 HD 音訊總線驅動程式會將緩存器對應至函式驅動程式可存取的系統虛擬位址。

傳回值

GetLinkPositionRegister 如果呼叫成功，則會傳回STATUS_SUCCESS。 否則，例程會傳回適當的錯誤碼。 下表顯示可能的傳回狀態代碼。

傳回碼 Description
STATUS_INVALID_HANDLE
 表示 句柄 參數值無效。

備註

如需詳細資訊，請參閱 時鐘和連結位置緩存器。

規格需求

需求 值
目標平台 桌面
標頭 hdaudio.h (包含 Hdaudio.h)
IRQL <=DISPATCH_LEVEL

另請參閱

AllocateCaptureDmaEngine

AllocateRenderDmaEngine

HDAUDIO_BUS_INTERFACE

HDAUDIO_BUS_INTERFACE_BDL

HDAUDIO_BUS_INTERFACE_V2