(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 |
---|---|
|
表示 句柄 參數值無效。 |
備註
如需詳細資訊,請參閱 時鐘和連結位置緩存器。
規格需求
需求 | 值 |
---|---|
目標平台 | 桌面 |
標頭 | hdaudio.h (包含 Hdaudio.h) |
IRQL | <=DISPATCH_LEVEL |